Name | Date | Size | #Lines | LOC | ||
---|---|---|---|---|---|---|
.. | 15-Mar-2021 | - | ||||
examples/ | H | 15-Mar-2021 | - | 794 | 731 | |
src/ | H | 15-Mar-2021 | - | 7,927 | 6,749 | |
tests/ | H | 15-Mar-2021 | - | 688 | 659 | |
.cargo-checksum.json | H A D | 15-Mar-2021 | 4.9 KiB | 1 | 1 | |
CHANGELOG.md | H A D | 15-Mar-2021 | 1.8 KiB | 72 | 59 | |
CODE_OF_CONDUCT.md | H A D | 15-Mar-2021 | 493 | 9 | 6 | |
Cargo.lock | H A D | 15-Mar-2021 | 7.2 KiB | 172 | 151 | |
Cargo.toml | H A D | 15-Mar-2021 | 1.4 KiB | 50 | 43 | |
LICENSE | H A D | 15-Mar-2021 | 16.3 KiB | 374 | 293 | |
README.md | H A D | 15-Mar-2021 | 3 KiB | 74 | 51 |
README.md
1# webrtc-sdp 2 3[![Crates.io](https://img.shields.io/crates/v/webrtc-sdp.svg)](https://crates.io/crates/webrtc-sdp) 4[![Build Status](https://travis-ci.org/mozilla/webrtc-sdp.svg?branch=master)](https://travis-ci.org/mozilla/webrtc-sdp) 5[![Codecov coverage status](https://codecov.io/gh/mozilla/webrtc-sdp/branch/master/graph/badge.svg)](https://codecov.io/gh/webrtc-sdp/webrtc-sdp) 6[![License: MPL 2.0](https://img.shields.io/badge/License-MPL%202.0-brightgreen.svg)](#License) 7[![dependency status](https://deps.rs/repo/github/mozilla/webrtc-sdp/status.svg)](https://deps.rs/repo/github/mozilla/webrtc-sdp) 8 9A SDP parser written in Rust specifically aimed to handle WebRTC SDP offers and answers. 10 11## Dependecies 12 13* Rust >= 1.36.0 14* log module 15* serde module 16* serde-derive module 17 18Cargo installs the missing modules automatically when building webrtc-sdp for the first time. 19 20## The webrtc-sdp API 21 22The main function is: 23``` 24fn parse_sdp(sdp: &str, fail_on_warning: bool) -> Result<SdpSession, SdpParserError> 25``` 26The `sdp` parameter is the string which will get parsed. The `fail_on_warning` parameter determines how to treat warnings encountered during parsing. Any problems encountered during are stored until the whole string has been parsed. Any problem during parsing falls into two catgeories: 27 28* Fatal error preventing further parsing or processing of the SDP 29* Warning which don't block further processing of the SDP 30 31Warnings will be for example unknown parameters in attributes. Setting `fail_on_warning` to `true` makes most sense during development, when you want to be aware of all potential problems. In production `fail_on_warning` is expected to be `false`. 32 33`parse_sdp()` returns either an `SdpSession` struct ([code](https://github.com/mozilla/webrtc-sdp/blob/master/src/lib.rs#L137)) which contains all the parsed information. Or in case a fatal error was encountered (or if `fail_on_warning` was set to `true` and any warnings were encountered) an `SdpParserError` ([code](https://github.com/mozilla/webrtc-sdp/blob/master/src/error.rs#L117)) will be returned as a `Result`. 34 35## Examples 36 37The [file parser](https://github.com/mozilla/webrtc-sdp/blob/master/examples/file_parser.rs) in the webrtc-sdp package gives you an easy example of how to invoke the webrtc-sdp parser. 38 39## Contributing 40 41As the Travis CI runs are checking for code formating and clippy warnings please run the following commands locally, before submitting a Pull Request. 42 43If you haven't clippy and Rust format installed already you add them like this: 44``` 45rustup component add rustfmt-preview 46rustup component add clippy 47``` 48 49Check with clippy for warnings in the code: 50``` 51cargo clippy 52``` 53 54And format all of the code according to Rust code style convention: 55``` 56cargo fmt --all 57``` 58 59## Fuzzing 60 61Install cargo-fuzz like this: 62``` 63cargo install cargo-fuzz 64``` 65 66With rust nightly you can start fuzzing like this: 67``` 68cargo fuzz run fuzz_target_parse_sdp 69``` 70 71## License 72 73Licensed under [MPL-2.0](https://www.mozilla.org/MPL/2.0/) 74