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

NAME

wsdl-parser - Parses a WSDL file to generate a SOAP client

VERSION

This documentation refers to wsdl-parser version 0.06.

SYNOPSIS

   wsdl-parser [options] [--module-base|-b Pkg WSDL
   wsdl-parser [options] Pkg::Name WSDL [--namespace-map|-n] 'xsd-namespace=perl-namespace' ...
   wsdl-parser [options] Pkg::Name WSDL [--map-file|-f] file
   wsdl-parser [options] [--show|-s] WSDL

 OPTIONS:
  WSDL          The WSDL file or URL to get the WSDL from
  Pkg::Name     The Perl package namespace you want the WSDLs operations accessible from

  -s --show     Show some info about the passed WSDL file eg it's operations
  -b --module-base[=]str
                Let the W3C::SOAP auto generate package names for any WSDLs or
                XSDs found while processing. (Note packages will be valid
                but not pretty)
  -n --namespace-map ns=package
                A mapping of XSD namespaces (ns) to perl package names
                (package), it is required when writing XSD files if --module-base
                is not specified. (This results in controlled namespaces but can
                be a lot of work to setup)
  -f --map-file[=]file
                File that contains namespace mappings instead of having to
                write all the mappings on the command line and can be used
                again for other WSDLs or regenerating the current one.
  -l --lib[=]dir
                Directory where generated modules should be writted, the
                default is ./lib
  -p --path[=]str
                Extra template toolkit directories if you want to override
                default templates.
  -S --save     Save all downloaded WSDLs & XSDs

  -v --verbose  Show more detailed option
     --version  Prints the version information
     --help     Prints this help information
     --man      Prints the full documentation for wsdl-parser

DESCRIPTION

There are three basic modes of operation of wsdl-parser:

show

When using the --show option wsdl-parser dumps a human readable version of what the WSDL can do.

basic

In basic mode occurs when using the --module-base option W3C::SOAP will generate all of the module names for the WSDL and XSDs processed. The names are based on the target namespaces of each WSDL or XSD so they might end up being rather long and unwieldy.

advanced

In the advanced mode all namespaces must be specified either by --namespace-map on the command line or by specifying a --map-file. The easiest way to do this is to run wsdl-parser and look at the thrown errors (which should include the unmapped XSD namespace and append that namespace to the end of the command and run again. This may take several iterations to get all of the namespaces specified.

map-file

The file format is = or tab separated rows of 2 elements with the first being the XSD namespace and the second being the perl package namespace. Lines with nothing on them are ignored as are lines starting with a hash (#).

An example map file:

 # this is ignored
 http://example.com/=XSD::Example

 http://example.com/data=XSD::Example::Data

SUBROUTINES/METHODS

CONFIGURATION AND ENVIRONMENT

DEPENDENCIES

INCOMPATIBILITIES

BUGS AND LIMITATIONS

There are no known bugs in this module.

Please report problems to Ivan Wills (ivan.wills@gmail.com).

Patches are welcome.

AUTHOR

Ivan Wills - (ivan.wills@gmail.com)

LICENSE AND COPYRIGHT

Copyright (c) 2012 Ivan Wills (14 Mullion Close, Hornsby Heights, NSW Australia 2077). All rights reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic. This program 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.