Crate ssml_parser

Expand description

§SSML Parser

This crate handles parsing SSML (Speech Synthesis Markup Language). It’s main aim is to facilitate the development of TTS (Text-To-Speech) and applications that utilise sythesised audio. Functionality for writing XML is limited and could do with improvements for ergonomics.

Currently it contains a full implementation of the SSML 1.1 specification including custom tags. Text within custom tags is assumed to be synthesisable though it is possible to change this behaviour when extracting the text.

Below is a simple example:

use ssml_parser::parse_ssml;

let ssml = r#"<?xml version="1.0"?>
   <speak version="1.1"
          xmlns="http://www.w3.org/2001/10/synthesis"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://www.w3.org/2001/10/synthesis
                      http://www.w3.org/TR/speech-synthesis11/synthesis.xsd"
          xml:lang="en-US">
     <p>
       <s>You have 4 new messages.</s>
       <s>The first is from Stephanie Williams and arrived at <break/> 3:45pm.
       </s>
       <s>
         The subject is <prosody rate="20%">ski trip</prosody>
       </s>
     </p>
   </speak>"#;

let result = parse_ssml(ssml).unwrap();

// We can now see the text with tags removed:
println!("{}", result.get_text());

// And can loop over all the SSML tags and get their character indexes:
for tag in result.tags() {
   println!("{:?}", tag);
}

Re-exports§

pub use crate::parser::parse_ssml;

Modules§

elements: Documentation comments are taken in part from the SSML specification which can be found here. All copied sections will be marked with:
parser: Handles parsing SSML input and returning our Ssml structure, contains a simple parse function that sets up the parser with the default options and hides it as well as a parser type a user can construct themselves to have more control over parsing.

Structs§

Ssml: Holds parsed SSML string with the text minus tags and the tag information
TransformedSsml: After applying a transformation to SSML writes out the new SSML string and also the text to be processed by a speech synthesiser. Assumes all text in custom tags is synthesisable.

Enums§