LWP - Library for WWW access in Perl
The architecture of the library is object oriented. The user agent, requests sent and responses received from the WWW server are all represented by objects. This makes a simple but yet powerful interface to these services. The interface is easy to extend and customize for your needs.
You should first read the documentation for LWP::UserAgent. Then you might want to look at how the scripts request and mirror are implemented. More examples are found among the tests in the t directory.
request
mirror
This table should give you a quick overview of the classes used by the library. Indentation shows class inheritance.
LWP::MemberMixin -- Access to member variables of Perl5 classes LWP::UserAgent -- WWW user agent class LWP::Protocol -- Interface to various protocol schemes LWP::Protocol::http -- http:// access LWP::Protocol::file -- file:// access ... LWP::Socket -- Socket creation and reading (LWP::Protocol::http) HTTP::Headers -- MIME/RFC822 style header (used by HTTP::Message) HTTP::Message -- HTTP style message HTTP::Request -- HTTP request HTTP::Response -- HTTP response URI::URL -- Uniform Resource Locators
The following modules provide various functions and definitions.
LWP -- This file. Library version number. LWP::MediaTypes -- MIME types configuration (text/html etc.) LWP::Debug -- Debug logging module LWP::Simple -- Simplified procedural interface for common functions HTTP::Status -- HTTP status code (200 OK etc) HTTP::Date -- Date parsing module for HTTP date formats
This package ows a lot in motivation, design, and code, to the libwww-perl library for Perl 4, maintained by Roy Fielding <fielding@ics.uci.edu>.
That package used work from Alberto Accomazzi, James Casey, Brooks Cutter, Martijn Koster, Oscar Nierstrasz, Mel Melchner, Gertjan van Oosten, Jared Rhine, Jack Shirazi, Gene Spafford, Marc VanHeyningen, Steven E. Brenner, Marion Hakanson, Waldemar Kebsch, Tony Sanders, and Larry Wall; see the libwww-perl library for details.
The primary architect for this Perl 5 library is Martijn Koster and Gisle Aas, with lots of help from Graham Barr, Tim Bunce, Andreas Koenig, Jared Rhine, and Jack Shirazi.
Copyright (c) 1995 Martijn Koster. All rights reserved. Copyright (c) 1995 Gisle Aas. All rights reserved.
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
The latest version of this library is likly to be available from:
http://www.oslonett.no/home/aas/perl/www/
The best place to discuss this code is on the <libwww-perl@ics.uci.edu> mailing list. The email addresses of the principal authors are <m.koster@webcrawler.com> and <aas@oslonett.no>.
To install LWP, copy and paste the appropriate command in to your terminal.
cpanm
cpanm LWP
CPAN shell
perl -MCPAN -e shell install LWP
For more information on module installation, please visit the detailed CPAN module installation guide.