Metadata-Version: 2.2
Name: ssml-maker
Version: 0.1.0
Summary: A Python library for building SSML (Speech Synthesis Markup Language) documents
Home-page: https://github.com/yourusername/ssml-maker
Author: Kevin Sallée
Author-email: kevin.sallee@gmail.com
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-python
Dynamic: summary

# SSML Maker

A Python library for building SSML (Speech Synthesis Markup Language) documents with a fluent interface.

## Installation

```bash
pip install ssml-maker
```

## Features

- Fluent interface for building SSML documents
- Support for all major SSML elements
- Type hints and proper documentation
- Comprehensive test coverage
- Input validation and error handling

## Quick Start

```python
from ssml_maker import Speech, InterpretAs, ProsodyConfig, ProsodyRate

# Create a simple SSML document
with Speech() as speech:
    speech.add_text("Here are ")
    with speech.say_as(InterpretAs.CHARACTERS):
        speech.add_text("SSML")
    speech.add_text(" examples")

# Get the SSML string
ssml_string = speech.build()
print(ssml_string)
```

## Advanced Usage

### Prosody Control

```python
from ssml_maker import ProsodyConfig, ProsodyRate, ProsodyPitch, VolumeLevel

config = ProsodyConfig(
    rate=ProsodyRate.FAST,
    pitch=ProsodyPitch.HIGH,
    volume=VolumeLevel.LOUD
)

with Speech() as speech:
    with speech.prosody(config):
        speech.add_text("This will be spoken quickly, with high pitch and loud volume")
```

### Voice Selection

```python
with Speech() as speech:
    with speech.voice(name="Joanna", language="en-US", gender="female"):
        speech.add_text("This text will be spoken by Joanna")
```

### Phonetic Pronunciation

```python
from ssml_maker import PhoneticAlphabet

with Speech() as speech:
    with speech.phoneme(PhoneticAlphabet.IPA, "pɪˈkɑːn"):
        speech.add_text("pecan")
```

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

## License

This project is licensed under the MIT License - see the LICENSE file for details.
