################################################################################
# File: ....................... README
# Original Author: ............ Jeff Nokes
# Last modified by: ........... Jeff Nokes
# Last modified: .............. 03/15/2007 @ 14:46
################################################################################





DESCRIPTION

eBay Perl SDK

This library is intended to provide a Perl based interface for the public eBay
web services API (http://developer.ebay.com).  Inside this library are a group
of modules used to provide eBay API generic and XML interface specific class
hierarchies, that are extended via the auto-generated API call/data-type
sub-classes.  The tools provided in this library contain a script used to
generate these sub-classes on the developer's behalf; please reference
INSTALL for more information on how to use this tool.

This is a pure-Perl library, that is almost entirely object oriented (OO).  And
in keeping with traditional Perl philosophies, it was decided to utilize as many
existing CPAN modules/libraries as possible, to implement it.

eBay Inc. currently supports the following interfaces to its API:

  REST (partially supported as of 12/11/2006)
  SOAP
  XML

This library currently supports the following eBay supported interfaces:

  XML

... and was designed so that future support for other protocol
interfaces could be easily added.


This library includes the following features:

  (1)  Ability to make XML API calls to the eBay web services public interface
       using HTTP/HTTPS.

  (2)  Ability to: execute a single API call in a serial fashion; group multiple
       API calls to be executed in serial, or asynchronously in parallel via
       the LWP::Parallel module.

  (3)  Ability to stub out eBay API error responses for error handling testing,
       simulating a real API error, even though a real request was never sent.

  (4)  Ability to make most global library configurations using ENVironment
       variables and/or OO methods.

  (5)  Error exception class, extendable to the end-user's Perl application if
       one so chooses.

  (6)  Tool to auto-generate all specific API call/data-type classes.  As eBay
       up rev's its API interface version, the end-user can just re-generate
       all of the call/data-type classes with the new WSDL or Schema (.xsd)
       published by eBay.  (Reference INSTALL for more information)


For more information on how to use eBay's web services API, please visit the
publicly available web site, http://developer.ebay.com.





INSTALLATION

This library can be installed via the traditional Perl process of:

   perl Makefile.PL
   make
   make test
   make install

Users may also use `perl -MCPAN` if the module is available on CPAN mirrors.
Please reference INSTALL for more information on the recommended full
intallation process.





DEPENDENCIES

This module requires this version (or higher) of Perl:

   5.008001


This module requires these versions (or higher) of other modules and libraries:

   Compress::Zlib      v 1.41
   Crypt::SSLeay       v 0.51
   Cwd                 v 3.18
   Data::Dumper        v 2.121
   Devel::StackTrace   v 1.03
   Encode              v 1.9801
   Error               v 0.15
   Exception::Class    v 1.14
   Exporter            v 5.567
   File::Find          v 1.05
   File::Path          v 1.06
   File::Spec          v 3.18
   Getopt::Long        v 2.34
   HTTP::Headers       v 1.47
   HTTP::Request       v 1.34
   HTTP::Status        v 1.28
   IO::File            v 1.10
   LWP::Parallel       v 2.57
   LWP::UserAgent      v 2.023
   Params::Validate    v 0.74
   Scalar::Util        v 1.11
   Time::HiRes         v 1.51
   Time::localtime     v 1.02
   XML::Simple         v 2.09
   XML::Writer         v 0.600
   XML::Tidy           v 1.2.54HJnFa

Note:  The module versions mentioned above are the versions that this library
was developed and tested with.  It is assumed that all later versions of
these same modules will also work, but please reference each module's specific
documentation for it's functional API preservation, or lack thereof.





CREDITS

  Original authors/contributors in alphabetical order:

    Robert Bradley
    Mike Evans
    Milenko Milanovic
    Jeff Nokes

    perl@ebay.com





COPYRIGHT AND LICENCE

Copyright (C) 1995-2006 eBay Inc. All Rights Reserved.

This library is licensed under the terms of the Common Development and
Distribution License ("CDDL").  The full text of this license is available
with this module distribution in the file named:

COMMON_DEVELOPMENT_AND_DISTRIBUTION_LICENSE.html