معرفی شرکت ها
aiopolly-0.2.2
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
Asynchronous wrapper for AWS Polly API
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | aiopolly-0.2.2 |
| نام | aiopolly |
| نسخه کتابخانه | 0.2.2 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | MrMrRobat |
| ایمیل نویسنده | appkiller16@gmail.com |
| آدرس صفحه اصلی | https://github.com/MrMrRobat/aiopolly |
| آدرس اینترنتی | https://pypi.org/project/aiopolly/ |
| مجوز | MIT |
# aiopolly
[](https://python.org)
[](https://pypi.python.org/pypi/aiopolly)
[](https://docs.aws.amazon.com/en_us/polly/latest/dg/what-is.html)
aiopolly is an asynchronous library for [Amazon Polly API](https://docs.aws.amazon.com/en_us/polly/latest/dg/API_Reference.html) which is written with [asyncio](https://docs.python.org/3/library/asyncio.html) and [aiohttp](https://github.com/aio-libs/aiohttp) and uses [pydantic](https://github.com/samuelcolvin/pydantic) models
# Features
- Asynchronous
- Respects PEP-8 (no camelCase args and vars)
- Provides easy way to work with SSML tags and lexicons
- Has mapped and classified AWS API exceptions
- Has audio convert support and built-in async opus converter
# Installation
```bash
$ pip install aiopolly
```
# Getting started
To work with AWS Polly you need AWS account, IAM User and it's credentials, [here's the instructions](https://docs.aws.amazon.com/en_us/polly/latest/dg/setting-up.html) how to get it
Then you can init this class using one of two methods:
1) Provide your access and secret keys directly:
```python
from aiopolly import Polly
polly = Polly(access_key='your_access_key', secret_key='your_secret_key')
```
2) Create a ~/.aws/credentials file with following data:
```
[default]
aws_access_key_id = your_access_key
aws_secret_access_key = your_secret_key
```
And init class without any auth params:
```python
from aiopolly import Polly
polly = Polly()
```
# Examples
## Many voices
```python
import asyncio
import time
from aiopolly import Polly, types
async def main():
time_start = time.time()
# Initializing AWS Polly client with default output_format
polly = Polly(output_format=types.AudioFormat.mp3)
voices = await polly.describe_voices()
text = 'Whatever you can do I can override it, got a million ways to synthesize it'
# Asynchronously synthesizing text with all available voices
synthesized = await voices.synthesize_speech(text, language_code=types.LanguageCode.en_US)
# Asynchronously saving each synthesized audio on disk
await asyncio.gather(
*(speech.save_on_disc(directory='examples') for speech in synthesized)
)
# Counting how many characters were synthesized
characters_synthesized = sum(speech.request_characters for speech in synthesized)
print(f'{characters_synthesized} characters are synthesized on {len(synthesized)}speech'
f'and saved on disc in {time.time() - time_start} seconds!')
loop = asyncio.get_event_loop()
loop.run_until_complete(main())
```
## Managing lexicons
```python
import asyncio
from aiopolly import Polly
from aiopolly.types import Alphabet, AudioFormat, LanguageCode, VoiceID
from aiopolly.utils.lexicon import new_lexicon, new_lexeme
async def main():
# Creating a new Polly instance with default output format 'mp3'
polly = Polly(output_format=AudioFormat.mp3)
text = 'Python is a beautiful programming language which is commonly used for web backend and ML. ' \
'It also has cool style guides listed in PEP-8, and many community libraries like aiopolly or aiogram.'
# Creating new lexemes
python_lexemes = [
new_lexeme(grapheme='PEP', alias='Python Enhancement Proposals'),
new_lexeme(grapheme='ML', alias='Machine Learning'),
new_lexeme(grapheme='aiopolly', phoneme='eɪˈaɪoʊˈpɑli'),
new_lexeme(grapheme='aiogram', phoneme='eɪˈaɪoʊˌgræm')
]
# Creating a new lexicon with 'ipa' alphabet and 'en_US' language code
lexicon = new_lexicon(alphabet=Alphabet.ipa, lang=LanguageCode.en_US, lexemes=python_lexemes)
# Putting lexicon on Amazon server
lexicon_name = 'PythonML'
await polly.put_lexicon(lexicon_name=lexicon_name, content=lexicon)
# Synthesizing speech with lexicon we just created
# (we don't need to specify required param "output_format", as we using it by default)
speech = await polly.synthesize_speech(text, voice_id=VoiceID.Matthew, lexicon_names=[lexicon_name])
# Saving speech on disk with default name
await speech.save_on_disc()
loop = asyncio.get_event_loop()
loop.run_until_complete(main())
```
## Using SSML Text
aiopolly got built-in ssml-text factory which you can use to manage your ssml text:
```python
import asyncio
from aiopolly import Polly
from aiopolly.types import AudioFormat, VoiceID, TextType
from aiopolly.utils.ssml import ssml_text, prosody
from aiopolly.utils.ssml.params import Volume, Pitch, Rate
super_fast = prosody(f'''\
Uh, sama lamaa duma lamaa you assuming I'm a human\
What I gotta do to get it through to you I'm superhuman\
Innovative and I'm made of rubber\
So that anything you say is ricocheting off of me and it'll glue to you\
I'm devastating more than ever demonstrating\
How to give a motherfuckin' audience a feeling like it's levitating\
Never fading and I know that the haters are forever waiting\
For the day that they can say I fell off they'd be celebrating\
'Cause I know the way to get 'em motivated
''',
rate=Rate.x_fast, volume=Volume.x_loud, pitch=Pitch.high
)
async def main():
# Creating a new Polly instance with default output format 'mp3'
polly = Polly(output_format=AudioFormat.mp3)
text = ssml_text(super_fast)
speech = await polly.synthesize_speech(text, voice_id=VoiceID.Matthew, text_type=TextType.ssml)
await speech.save_on_disc(directory='speech')
loop = asyncio.get_event_loop()
loop.run_until_complete(main())
```
## Using default params
You can init Polly client with any default params.
Those will be used when same params in API methods remain empty.
```python
from aiopolly import Polly, types
polly = Polly(
voice_id=types.VoiceID.Joanna,
output_format=types.AudioFormat.ogg_vorbis,
sample_rate='16000',
speech_mark_types=['ssml'],
text_type=types.TextType.ssml,
language_code=types.LanguageCode.en_US,
lexicon_names=['myLexicon', 'alsoMyLexicon'],
output_s3_key_prefix='s3_key_prefix',
output_s3_bucket_name='s3_bucket_name',
include_additional_language_codes=True,
**{'other_default_param': 'value'}
)
```
## Using built-in OpusConverter
For this to work you need ffmpeg and libopus installed on your system
```python
import asyncio
from aiopolly import Polly
from aiopolly.types import AudioFormat, TextType, VoiceID
from aiopolly.utils.converter import OpusConverter
from aiopolly.utils.ssml import ssml_text, pause, Strength
async def main():
# Creating instance if OpusConverter
converter = OpusConverter(auto_convert=True, keep_original=True)
polly = Polly(output_format=AudioFormat.mp3, converter=converter)
text = ssml_text(f'''
sendVoice
Use this method to send audio files, if you want Telegram clients to display the file as a playable voice message.
For this to work, your audio must be in an {pause(Strength.none)}.ogg file encoded with OPUS
(other formats may be sent as Audio or Document)
''')
# Synthesizing speech as usual, it will be converted automatically
speech = await polly.synthesize_speech(text, voice_id=VoiceID.Matthew, text_type=TextType.ssml)
# Saving speech on disk with default name
await speech.save_on_disc(directory='speech')
await speech.save_on_disc(directory='speech', converted=False)
loop = asyncio.get_event_loop()
loop.run_until_complete(main())
```
# To-Do:
- Test Synthesis tasks (not tested yet)
- Write tests
- Get rid of botocore (built-in request signer needed)
- Work on converter API?
- More docs?
###### Inspired by Alex Root Junior's [aiogram](https://github.com/aiogram/aiogram)
نیازمندی
| مقدار | نام |
|---|---|
| ==0.4.0 | aiofiles |
| >=3.5.4 | aiohttp |
| >=1.12.0 | botocore |
| >=2019.3.9 | certifi |
| >=0.27 | pydantic |
نحوه نصب
نصب پکیج whl aiopolly-0.2.2:
pip install aiopolly-0.2.2.whl
نصب پکیج tar.gz aiopolly-0.2.2:
pip install aiopolly-0.2.2.tar.gz