Metadata-Version: 2.1
Name: transcriber-wrapper
Version: 1.1.0
Summary: A wrapper of well-known translators that transform text into its phonetic transcription
Home-page: https://github.com/willianantunes/transcriber-wrapper
Author: Willian Antunes
Author-email: willian.lima.antunes@gmail.com
License: GPL3
Project-URL: Bug Tracker, https://github.com/willianantunes/transcriber-wrapper/issues
Description: # Transcriber Wrapper
        
        [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
        [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=willianantunes_transcriber-wrapper&metric=coverage)](https://sonarcloud.io/dashboard?id=willianantunes_transcriber-wrapper)
        [![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=willianantunes_transcriber-wrapper&metric=ncloc)](https://sonarcloud.io/dashboard?id=willianantunes_transcriber-wrapper)
        
        Inspired by [Phonemizer](https://github.com/bootphon/phonemizer), this a simpler version focused in transcription applications that work with IPA (International Phonetic Alphabet). This works like a wrapper which is responsible to call a back-end application, let's say [espeak-ng](https://github.com/espeak-ng/espeak-ng). It adds some features on top of it like `with stress` option.
        
        ## Usage
        
        For now, you need to install [espeak-ng](https://github.com/espeak-ng/espeak-ng) on your operational system. See [Dockerfile.dev](./Dockerfile.dev) as an example. After that, you can create a transcriber and then use it in your logic:
        
        ```python
        from typing import List
        
        import transcriber_wrapper
        
        # The standard language is "en-us"
        transcriber_en_us = transcriber_wrapper.build_transcriber()
        
        def do_the_thing(words: List[str]) -> List[str]:
            return transcriber_en_us.transcribe(words)
        ```
        
        ## Development
        
        ### Executing commands directly on the binaries
        
        After building the remote interpreter service, just enter in it:
        
            docker-compose run remote-interpreter sh
        
        You must be at `/usr/bin/`. Then try one of these below:
        
        ```shell
        espeak-ng "Hello my friend, stay awhile and listen!" -ven-us -x --ipa -q --sep=_
        espeak-ng "Curiosity" -ven-us -x --ipa -q --sep=" "
        espeak-ng "If you will not bow before a sultan, then you will cower before a sorcerer!" -ven-us -x --ipa -q
        ```
        
        Interesting links:
        
        - [Supported Languages](https://github.com/espeak-ng/espeak-ng/blob/53915bf0a7cd48f90c4a38ac52fff697723d9f4d/docs/languages.md)
        - [Command Line User Guide](https://github.com/espeak-ng/espeak-ng/blob/53915bf0a7cd48f90c4a38ac52fff697723d9f4d/src/espeak-ng.1.ronn)
        
        ### Updating pipenv dependencies
        
        If you update Pipfile, you can issue the following command to refresh your lock file:
        
            docker-compose run remote-interpreter pipenv update
        
Keywords: linguistics ipa transcriber phonetics pronunciation dictionary
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3.9
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
