yta-audio-narration 0.0.2__py3-none-any.whl → 0.0.4__py3-none-any.whl

yta_audio_narration/voices/google.py

@@ -1,266 +1,6 @@
 """
-This link could be interesting:
-- https://github.com/DarinRowe/googletrans
-
-You have a lot of information here:
-- https://en.wikipedia.org/wiki/IETF_language_tag
-- https://pypi.org/project/langcodes/
-- https://gtts.readthedocs.io/en/latest/module.html#languages-gtts-lang
+TODO: Do we make this optional or not? If it
+is optional we can allow installing the libs
+only if using this one.
 """
-from yta_audio_narration_common.consts import DEFAULT_VOICE
-from yta_audio_narration_common.enums import NarrationLanguage, VoiceEmotion, VoiceSpeed, VoicePitch
-from yta_audio_narration_common.voice import NarrationVoice
-from yta_constants.enum import YTAEnum as Enum
-from yta_constants.file import FileType
-from yta_programming.output import Output
-from typing import Union
-from gtts import gTTS
-
-
-"""
-This specific voice narration engine needs
-specific values and a different parameter
-handling.
-"""
-
-class GoogleNarrationLanguage(Enum):
-    """
-    The google narration languages accepted by their
-    API
-    """
-
-    SPANISH = 'es'
-    ENGLISH = 'en'
-
-    @staticmethod
-    def from_general_language(
-        language: NarrationLanguage
-    ) -> 'GoogleNarrationLanguage':
-        """
-        Turn a general 'language' instance into a Google
-        narration language instance.
-        """
-        return {
-            NarrationLanguage.DEFAULT: GoogleNarrationLanguage.SPANISH,
-            NarrationLanguage.SPANISH: GoogleNarrationLanguage.SPANISH,
-            NarrationLanguage.ENGLISH: GoogleNarrationLanguage.ENGLISH,
-        }[NarrationLanguage.to_enum(language)]
-
-"""
-The options below are specified even if we
-don't use them later when processing the 
-voice narration. This is to keep the same
-structure for any voice narration and to
-simplify the way we offer the options in
-an API that is able to make requests.
-
-If the engine doesn't have one specific
-option (I mean, you cannot handle the 
-narration speed, for example) we will allow
-the user choose 'normal' value and it will
-be handled just by ignoring it, but the user
-will be able to choose it.
-"""
-
-# 1. The voices we accept, as Enums
-class GoogleTld(Enum):
-
-    DEFAULT = DEFAULT_VOICE
-    SPANISH_SPAIN = 'es'
-    SPANISH_MEXICO = 'com.mx'
-    SPANISH_US = 'us'
-    # TODO: How can I get the list of Tlds?I need it
-
-    @staticmethod
-    def from_google_language(
-        language: GoogleNarrationLanguage
-    ) -> 'GoogleTld':
-        """
-        Turn the Google narration 'language' into the
-        corresponding Google TLD.
-        """
-        return {
-            GoogleNarrationLanguage.SPANISH: GoogleTld.SPANISH_SPAIN,
-            # TODO: Change this
-            GoogleNarrationLanguage.ENGLISH:  GoogleTld.SPANISH_US,
-        }[GoogleNarrationLanguage.to_enum(language)]
-
-# 2. The languages we accept
-LANGUAGE_OPTIONS = [
-    NarrationLanguage.SPANISH,
-    # TODO: Unavailable until I detect some valid TLDs
-    #NarrationLanguage.ENGLISH, 
-    NarrationLanguage.DEFAULT
-]
-
-# 3. The emotions we accept
-EMOTION_OPTIONS = [
-    VoiceEmotion.DEFAULT,
-    VoiceEmotion.NORMAL,
-]
-
-# 4. The speeds we accept
-SPEED_OPTIONS = [
-    VoiceSpeed.DEFAULT,
-    VoiceSpeed.NORMAL,
-    VoiceSpeed.SLOW,
-]
-
-# 5. The pitches we accept
-PITCH_OPTIONS = [
-    VoicePitch.DEFAULT,
-    VoicePitch.NORMAL,
-]
-
-
-class GoogleNarrationVoice(NarrationVoice):
-    """
-    Voice instance to be used when narrating with
-    Google engine.
-    """
-
-    @property
-    def processed_name(
-        self
-    ) -> str:
-        """
-        Get the usable name value from the one that has
-        been set when instantiating the instance.
-        """
-        # TODO: Maybe this DEFAULT value has to exist
-        # for each language so it chooses one voice name
-        # for that language
-        return (
-            GoogleTld.SPANISH_SPAIN.value
-            if GoogleTld.to_enum(self.name) == GoogleTld.DEFAULT else
-            GoogleTld.to_enum(self.name).value
-        )
-
-    @property
-    def processed_emotion(
-        self
-    ) -> str:
-        """
-        Get the usable emotion value from the one that
-        has been set when instantiating the instance.
-        """
-        # This narration is not able to handle any 
-        # emotion (at least by now)
-        return None
-    
-    @property
-    def processed_speed(
-        self
-    ) -> bool:
-        """
-        Get the usable speed value from the one that
-        has been set when instantiating the instance.
-        """
-        # This value is actually saying if we are using
-        # the slow mode or not
-        return {
-            VoiceSpeed.SLOW: True,
-            VoiceSpeed.DEFAULT: False,
-            VoiceSpeed.NORMAL: False
-        }[self.speed]
-
-    @property
-    def processed_pitch(
-        self
-    ) -> float:
-        """
-        Get the usable pitch value from the one that
-        has been set when instantiating the instance.
-        """
-        # By now we are not handling the pitch with
-        # this voice
-        return None
-    
-    @property
-    def processed_language(
-        self
-    ) -> str:
-        """
-        Get the usable language value from the one that
-        has been set when instantiating the instance.
-        """
-        return GoogleNarrationLanguage.from_general_language(self.language).value
-
-    def validate_and_process(
-        self,
-        name: str,
-        emotion: VoiceEmotion,
-        speed: VoiceSpeed,
-        pitch: VoicePitch,
-        language: NarrationLanguage
-    ):
-        GoogleTld.to_enum(name)
-        if VoiceEmotion.to_enum(emotion) not in EMOTION_OPTIONS:
-            raise Exception(f'The provided {emotion} is not valid for this narration voice.')
-        if VoiceSpeed.to_enum(speed) not in SPEED_OPTIONS:
-            raise Exception(f'The provided {speed} is not valid for this narration voice.')
-        if VoicePitch.to_enum(pitch) not in PITCH_OPTIONS:
-            raise Exception(f'The provided {pitch} is not valid for this narration voice.')
-        if NarrationLanguage.to_enum(language) not in LANGUAGE_OPTIONS:
-            raise Exception(f'The provided {language} is not valid for this narration voice.')
-        
-    @staticmethod
-    def default():
-        return GoogleNarrationVoice(
-            name = GoogleTld.DEFAULT.value,
-            emotion = VoiceEmotion.DEFAULT,
-            speed = VoiceSpeed.DEFAULT,
-            pitch = VoicePitch.DEFAULT,
-            language = NarrationLanguage.DEFAULT
-        )
-        # TODO: This was in the previous version, remove when
-        # confirmed that the above is working
-        # return GoogleNarrationVoice('', '', 130, 1.0, NarrationLanguage.DEFAULT)
-    
-# The voices but for a specific language, to be able to
-# choose one when this is requested from the outside
-def get_narrator_names_by_language(
-    language: NarrationLanguage
-) -> list[str]:
-    language = NarrationLanguage.to_enum(language)
-    language = (
-        NarrationLanguage.SPANISH
-        if language is NarrationLanguage.DEFAULT else
-        language
-    )
-
-    return {
-        NarrationLanguage.SPANISH: [
-            GoogleTld.DEFAULT.value,
-            GoogleTld.SPANISH_SPAIN.value,
-            GoogleTld.SPANISH_MEXICO.value,
-            GoogleTld.SPANISH_US.value
-        ]
-    }[language]
-
-
-# All the remaining functionality we need to make it
-# work properly
-def narrate(
-    text: str,
-    voice: GoogleNarrationVoice = GoogleNarrationVoice.default(),
-    output_filename: Union[str, None] = None
-):
-    """
-    Creates an audio narration of the provided 'text' with the Google voice and stores it
-    as 'output_filename'. This will use the provided 'language' language for the narration.
-    """
-    output_filename = Output.get_filename(output_filename, FileType.AUDIO)
-    
-    tld = GoogleTld.from_google_language(voice.processed_language).value
-
-    gTTS(
-        text = text,
-        lang = voice.processed_language,
-        tld = tld,
-        slow = voice.processed_speed
-    ).save(
-        output_filename
-    )
-
-    return output_filename
+from yta_audio_narration_google import GoogleNarrationLanguage, GoogleTld, LANGUAGE_OPTIONS, EMOTION_OPTIONS, SPEED_OPTIONS, PITCH_OPTIONS, GoogleNarrationVoice, get_narrator_names_by_language, narrate

yta_audio_narration/voices/microsoft.py

@@ -1,209 +1,6 @@
-from yta_audio_narration_common.enums import NarrationLanguage, VoiceEmotion, VoiceSpeed, VoicePitch
-from yta_audio_narration_common.consts import DEFAULT_VOICE
-from yta_audio_narration_common.voice import NarrationVoice
-from yta_constants.enum import YTAEnum as Enum
-from yta_constants.file import FileType
-from yta_programming.output import Output
-from typing import Union
-
-import pyttsx3
-
-
 """
-The options below are specified even if we
-don't use them later when processing the 
-voice narration. This is to keep the same
-structure for any voice narration and to
-simplify the way we offer the options in
-an API that is able to make requests.
+TODO: Do we make this optional or not? If it
+is optional we can allow installing the libs
+only if using this one.
 """
-
-# 1. The voices we accept, as Enums
-class MicrosoftVoiceName(Enum):
-    """
-    Available voices. The value is what is used
-    for the audio creation.
-    """
-
-    DEFAULT = DEFAULT_VOICE
-    SPANISH_SPAIN = 'HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Speech\Voices\Tokens\TTS_MS_ES-ES_HELENA_11.0'
-    SPANISH_MEXICO = 'HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Speech\Voices\Tokens\TTS_MS_ES-MX_SABINA_11.0'
-    # TODO: There are more voices
-
-# 2. The languages we accept
-LANGUAGE_OPTIONS = [
-    NarrationLanguage.DEFAULT,
-    NarrationLanguage.SPANISH
-]
-
-# 3. The emotions we accept
-EMOTION_OPTIONS = [
-    VoiceEmotion.DEFAULT,
-    VoiceEmotion.NORMAL,
-]
-
-# 4. The speeds we accept
-SPEED_OPTIONS = [
-    VoiceSpeed.DEFAULT,
-    VoiceSpeed.NORMAL,
-    VoiceSpeed.SLOW,
-    VoiceSpeed.FAST
-]
-
-# 5. The pitches we accept
-PITCH_OPTIONS = [
-    VoicePitch.DEFAULT,
-    VoicePitch.NORMAL,
-]
-
-
-class MicrosoftNarrationVoice(NarrationVoice):
-    """
-    Voice instance to be used when narrating with
-    Microsoft engine.
-    """
-
-    @property
-    def processed_name(
-        self
-    ) -> str:
-        """
-        Get the usable name value from the one that has
-        been set when instantiating the instance.
-        """
-        # TODO: Maybe this DEFAULT value has to exist
-        # for each language so it chooses one voice name
-        # for that language
-        return (
-            MicrosoftVoiceName.SPANISH_SPAIN.value
-            if MicrosoftVoiceName.to_enum(self.name) == MicrosoftVoiceName.DEFAULT else
-            MicrosoftVoiceName.to_enum(self.name).value
-        )
-
-    @property
-    def processed_emotion(
-        self
-    ) -> str:
-        """
-        Get the usable emotion value from the one that
-        has been set when instantiating the instance.
-        """
-        # This narration is not able to handle any 
-        # emotion (at least by now)
-        return None
-    
-    @property
-    def processed_speed(
-        self
-    ) -> int:
-        """
-        Get the usable speed value from the one that
-        has been set when instantiating the instance.
-        """
-        # This value is actually the amount of words per
-        # minute to be said during the speech
-        speed = (
-            VoiceSpeed.NORMAL
-            if self.speed == VoiceSpeed.DEFAULT else
-            self.speed
-        )
-
-        return {
-            VoiceSpeed.SLOW: 160,
-            VoiceSpeed.NORMAL: 200,
-            VoiceSpeed.FAST: 240
-        }[speed]
-
-    @property
-    def processed_pitch(
-        self
-    ) -> float:
-        """
-        Get the usable pitch value from the one that
-        has been set when instantiating the instance.
-        """
-        # By now we are not handling the pitch with
-        # this voice
-        return None
-    
-    @property
-    def processed_language(
-        self
-    ) -> str:
-        """
-        Get the usable language value from the one that
-        has been set when instantiating the instance.
-        """
-        # By now we are not handling the language with
-        # this voice
-        return None
-
-    def validate_and_process(
-        self,
-        name: str,
-        emotion: VoiceEmotion,
-        speed: VoiceSpeed,
-        pitch: VoicePitch,
-        language: NarrationLanguage
-    ):
-        MicrosoftVoiceName.to_enum(name)
-        if VoiceEmotion.to_enum(emotion) not in EMOTION_OPTIONS:
-            raise Exception(f'The provided {emotion} is not valid for this narration voice.')
-        if VoiceSpeed.to_enum(speed) not in SPEED_OPTIONS:
-            raise Exception(f'The provided {speed} is not valid for this narration voice.')
-        if VoicePitch.to_enum(pitch) not in PITCH_OPTIONS:
-            raise Exception(f'The provided {pitch} is not valid for this narration voice.')
-        if NarrationLanguage.to_enum(language) not in LANGUAGE_OPTIONS:
-            raise Exception(f'The provided {language} is not valid for this narration voice.')
-        
-    @staticmethod
-    def default():
-        return MicrosoftNarrationVoice(
-            name = MicrosoftVoiceName.DEFAULT.value,
-            emotion = VoiceEmotion.DEFAULT,
-            speed = VoiceSpeed.DEFAULT,
-            pitch = VoicePitch.DEFAULT,
-            language = NarrationLanguage.DEFAULT
-        )
-
-# The voices but for a specific language, to be able to
-# choose one when this is requested from the outside
-def get_narrator_names_by_language(
-    language: NarrationLanguage
-) -> list[str]:
-    language = NarrationLanguage.to_enum(language)
-    language = (
-        NarrationLanguage.SPANISH
-        if language is NarrationLanguage.DEFAULT else
-        language
-    )
-
-    return {
-        NarrationLanguage.SPANISH: [
-            MicrosoftVoiceName.DEFAULT.value,
-            MicrosoftVoiceName.SPANISH_SPAIN.value,
-            MicrosoftVoiceName.SPANISH_MEXICO.value
-        ]
-    }[language]
-
-# All the remaining functionality we need to make it
-# work properly
-def narrate(
-    text: str,
-    voice: MicrosoftNarrationVoice = MicrosoftNarrationVoice.default(),
-    output_filename: Union[str, None] = None
-):
-    """
-    Creates an audio narration of the provided 'text'
-    and stores it as 'output_filename'.
-    """
-    output_filename = Output.get_filename(output_filename, FileType.AUDIO)
-    
-    engine = pyttsx3.init()
-    engine.setProperty('voice', voice.processed_name)
-    # Default speed is 200 (wpm)
-    engine.setProperty('rate', voice.processed_speed)
-    engine.save_to_file(text, output_filename)
-    engine.runAndWait()
-
-    return output_filename
+from yta_audio_narration_microsoft import MicrosoftNarrationLanguage, LANGUAGE_OPTIONS, EMOTION_OPTIONS, SPEED_OPTIONS, PITCH_OPTIONS, MicrosoftNarrationVoice, get_narrator_names_by_language, narrate

{yta_audio_narration-0.0.2.dist-info → yta_audio_narration-0.0.4.dist-info}/METADATA

@@ -1,16 +1,16 @@
 Metadata-Version: 2.3
 Name: yta-audio-narration
-Version: 0.0.2
+Version: 0.0.4
 Summary: Youtube Autonomous Audio Narration Module.
 Author: danialcala94
 Author-email: danielalcalavalera@gmail.com
 Requires-Python: ==3.9
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.9
-Requires-Dist: gtts (>=2.5.1,<3.0.0)
-Requires-Dist: pyttsx3 (>=2.90,<3.0)
 Requires-Dist: yta_audio_narration_common (>=0.0.1,<1.0.0)
 Requires-Dist: yta_audio_narration_coqui (>=0.0.1,<1.0.0)
+Requires-Dist: yta_audio_narration_google (>=0.0.1,<1.0.0)
+Requires-Dist: yta_audio_narration_microsoft (>=0.0.1,<1.0.0)
 Requires-Dist: yta_constants (>=0.0.1,<1.0.0)
 Requires-Dist: yta_file (>=0.0.1,<1.0.0)
 Requires-Dist: yta_file_downloader (>=0.0.1,<1.0.0)

{yta_audio_narration-0.0.2.dist-info → yta_audio_narration-0.0.4.dist-info}/RECORD

@@ -3,14 +3,14 @@ yta_audio_narration/enums.py,sha256=AsGCuRldH4Fa4XHMcS0SS1J_J6hAAKGo9rJ9ONd3erQ,
 yta_audio_narration/narrator.py,sha256=w-ACkH71vGhgAJxD1H3ToPDa3HQZOs5W0f1okeqyznE,20459
 yta_audio_narration/voices/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 yta_audio_narration/voices/coqui.py,sha256=e3-AOTW-IS9L9aYFrp-_sSE543vygKupW96xgYhL0cI,331
-yta_audio_narration/voices/google.py,sha256=ahK5MjxqsKQrx1lkmUVGZWs5MacNHyNUNww0qN0RzwM,8131
-yta_audio_narration/voices/microsoft.py,sha256=J5e4153secyta5tEWeNJTBYkkFhVYbM1zQ-e9y73Yr8,6375
+yta_audio_narration/voices/google.py,sha256=I4L2qm-zIXJ7eE23iM88m8rdEtO9L820vbnRJbQHhsg,328
+yta_audio_narration/voices/microsoft.py,sha256=6N1b5y4ayCPg5WdxhHZAVKSPCH3kta_J6YhDc3nVoB8,326
 yta_audio_narration/voices/open_voice.py,sha256=KlqIcsJXY581dURIqaFdk8noHsllzxZbQCkSyBxQ7QM,12981
 yta_audio_narration/voices/tetyys.py,sha256=PZB8CSkdAyStWsWwMqRvm0dlEefZViO5fcwwzNZE9IM,8291
 yta_audio_narration/voices/tiktok.py,sha256=R1lWljr0on_wamKBOUo9mbHXkmKvPbGYk2Ebfm6ua50,7482
 yta_audio_narration/voices/tortoise.py,sha256=qtL7Hl2f2bSjw2G81Ui-lTV8DZIcrJrKClkY3ulkf3I,6576
 yta_audio_narration/voices/ttsmp3.py,sha256=Zl3w4uY9n93RlpQv8c_1w22KZlb5BzHQRAqsheu5Gbo,8799
-yta_audio_narration-0.0.2.dist-info/LICENSE,sha256=6kbiFSfobTZ7beWiKnHpN902HgBx-Jzgcme0SvKqhKY,1091
-yta_audio_narration-0.0.2.dist-info/METADATA,sha256=43P7R0_QkDTD-xYCzhJNpiqqe0s_9Xv7nOCC8Ku_wNs,948
-yta_audio_narration-0.0.2.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
-yta_audio_narration-0.0.2.dist-info/RECORD,,
+yta_audio_narration-0.0.4.dist-info/LICENSE,sha256=6kbiFSfobTZ7beWiKnHpN902HgBx-Jzgcme0SvKqhKY,1091
+yta_audio_narration-0.0.4.dist-info/METADATA,sha256=D8D9saJl2JFiKQPQKB4qTKZh1dHSMkDYu-sWZN9pGB4,995
+yta_audio_narration-0.0.4.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
+yta_audio_narration-0.0.4.dist-info/RECORD,,