wsdl 0.1.2

Idiomatic Rust wrapper for WSDL
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

# WSDL Rust XML bindings

This library simply wraps a WSDL XML file with an idiomatic Rust interface.

The underlying XML library is `roxmltree`, on top of which this library declares
Rust newtypes to expose a native interface for reading WSDL files.

## Usage

```rust
# use anyhow::Result;

use wsdl::Wsdl;

fn example() -> Result<()> {
    let input = std::fs::read_to_string("/path/to/my/service.wsdl")?;
    let document = roxmltree::Document::parse(&input)?;

    let wsdl = Wsdl::new(&document);
    for service in wsdl.services()? {
        println!("Service: {}", service.name()?);
    }

    for binding in wsdl.bindings()? {
        println!(
            "Binding: {} -> {}",
            binding.name()?,
            binding.port_type()?.name()?
        );
    }

    Ok(())
}
```

See the [traversal](examples/traverse.rs) script for a complete (and usable) example. Run it with:
```ignore
cargo run --example traverse ./path/to/my/service.wsdl
```

## Error reporting

Errors generated by this library can be traced directly to the originating XML node. The originating node ID is
embedded in the first parameter of [WsError].

## Non-goals

* Parse the XSD-defined WSDL types. The XML specification is nebulous, and it would be best left to a separate crate that can also generate Rust bindings.