udemy-userAPI 0.3.5__py3-none-any.whl → 0.3.7__py3-none-any.whl

udemy_userAPI/bultins.py

@@ -1,11 +1,8 @@
-import json
 from typing import Any
-import requests
-from .api import get_links, remove_tag, parser_chapers, extract_files, HEADERS_USER, assets_infor, get_add_files, \
-    get_files_aule, get_external_liks, extract, get_pssh, organize_streams, get_mpd_file, get_highest_resolution
-from .sections import get_course_infor
-from .mpd_analyzer import MPDParser
+from .api import *
 from .exeptions import LoginException
+from .mpd_analyzer import MPDParser
+from .sections import get_course_infor
 
 
 class DRM:
@@ -108,6 +105,171 @@ class Files:
                     download_urls.append(dt_file)
         return download_urls
 
+class Quiz:
+    """Representa um quiz.
+    """
+
+    def __init__(self, quiz_data: dict):
+        """
+        Inicializa uma instância de Quiz.
+
+        Args:
+            quiz_data (dict): Dados do quiz.
+        """
+        self._data = quiz_data
+
+    @property
+    def id(self) -> int:
+        """Retorna o ID do quiz."""
+        return self._data.get('id', 0)
+
+    @property
+    def title(self) -> str:
+        """Retorna o título do quiz."""
+        return self._data.get('title', '')
+
+    @property
+    def type_quiz(self) -> str:
+        """Retorna o tipo de quiz (exame ou prática)."""
+        return self._data.get('type', '')
+
+    @property
+    def description(self) -> str:
+        """Retorna a descrição do quiz."""
+        return remove_tag(self._data.get('description', ''))
+
+    @property
+    def duration(self) -> int:
+        """Retorna a duração do quiz em minutos, se aplicável."""
+        duration: int = self._data.get('duration', 1)
+        if duration > 1:
+            return int(duration / 60)
+        else:
+            return 0
+
+    @property
+    def pass_percent(self) -> int:
+        """Retorna a porcentagem necessária para passar."""
+        return self._data.get('pass_percent', 0)
+
+    @property
+    def num_assessments(self) -> int:
+        """Retorna o número de perguntas do quiz."""
+        return self._data.get('num_assessments', 0)
+
+    def content(self) -> dict:
+        """Obtém o conteúdo do quiz."""
+        htmls = get_quizzes(lecture_id=self.id)
+        return htmls
+
+
+class Caption:
+    """Representa uma legenda."""
+
+    def __init__(self, caption: dict):
+        """
+        Inicializa uma instância de Caption.
+
+        Args:
+            caption (dict): Dados da legenda.
+        """
+        self._caption = caption
+
+    @property
+    def locale(self) -> str:
+        """Retorna o idioma."""
+        return self._caption.get('video_label', '')
+
+    @property
+    def status(self) -> str:
+        """Retorna o status da legenda 1 ou 0"""
+        return self._caption.get('status')
+
+    @property
+    def title(self) -> str:
+        """Retorna o título da legenda."""
+        return self._caption.get('title', '')
+
+    @property
+    def created(self) -> str:
+        """Retorna a data de criação da legenda."""
+        return self._caption.get('created', '')
+
+    @property
+    def id(self) -> int:
+        """Retorna o ID da legenda."""
+        return self._caption.get('id', 0)
+
+    @property
+    def url(self) -> str:
+        """Retorna a URL da legenda."""
+        return self._caption.get('url', '')
+
+    @property
+    def content(self) -> str:
+        """Obtém o conteúdo da legenda."""
+        if self.url:
+            r = requests.get(headers=HEADERS_USER, url=self.url)
+            if r.status_code == 200:
+                return r.text
+            else:
+                raise ConnectionError(
+                    f'status_code: {r.status_code}, Não foi possível obter o conteúdo da legenda!'
+                )
+        else:
+            raise FileNotFoundError(
+                'Não foi possível obter a URL da legenda!'
+            )
+
+class Captions:
+    """Gerencia as legendas de um vídeo."""
+
+    def __init__(self, caption_data: list):
+        """
+        Inicializa uma instância de Captions.
+
+        Args:
+            caption_data (list): Dados das legendas.
+        """
+        self._caption_data = caption_data
+
+    def languages(self) -> list[dict]:
+        """Retorna a lista de idiomas disponíveis na aula."""
+        langs = []
+        for caption in self._caption_data:
+            locale_id = caption.get('locale_id', '')
+            video_label = caption.get('video_label','')
+            if locale_id:
+                langs.append({'locale_id': locale_id,'locale':video_label})
+        return langs
+
+    def get_lang(self, locale_id: str) -> Caption:
+        """
+        Obtém a legenda para o idioma especificado.
+
+
+        Args:
+            locale_id (str): ID do idioma,pode ser obtido no método -> 'languages'
+
+        Returns:
+            Caption: Objeto Caption.
+
+        Raises:
+            FileNotFoundError: Se o idioma não estiver disponível na aula.
+        """
+        is_t = False
+        cpt = {}
+        for caption in self._caption_data:
+            if locale_id == caption.get('locale_id'):
+                is_t = True
+                cpt = caption
+        if not is_t:
+            raise FileNotFoundError(
+                'Esse idioma não está disponível nessa aula!'
+            )
+        c = Caption(caption=cpt)
+        return c
+
 
 class Lecture:
     """Cria objetos aula (lecture) do curso e extrai os dados."""
@@ -166,8 +328,8 @@ class Lecture:
         """
         thumbnail_sprite = self.__asset.get('thumbnail_sprite', {})
         return {
-            'thumbnail_vtt_url': thumbnail_sprite.get('vtt_url'),
-            'thumbnail_img_url': thumbnail_sprite.get('img_url')
+            'thumbnail_vtt_url': thumbnail_sprite.get('vtt_url',[]),
+            'thumbnail_img_url': thumbnail_sprite.get('img_url',[])
         }
 
     @property
@@ -178,7 +340,7 @@ class Lecture:
         Returns:
             str: O tipo de asset.
         """
-        return self.__asset.get('asset_type', 'Undefined')
+        return self.__asset.get('asset_type', '') or self.__data.get('_class','').replace('quiz','Quiz')
 
     @property
     def get_media_sources(self) -> list:
@@ -188,18 +350,23 @@ class Lecture:
         Returns:
             list: Uma lista contendo as fontes de mídia.
         """
-        return self.__asset.get('media_sources')
+        return self.__asset.get('media_sources',[])
 
     @property
-    def get_captions(self) -> list:
+    def get_captions(self) -> Captions:
         """
         Obtém as legendas.
 
         Returns:
-            list: Uma lista contendo as legendas.
-        """
-        return self.__asset.get('captions')
-
+            Captions: Objeto para gerenciar as legendas.
+        """
+        if self.__asset.get('captions',[]):
+            c = Captions(caption_data=self.__asset.get('captions',[]))
+            return c
+        else:
+            raise FileNotFoundError(
+                'Não foi encontrada legendas nessa aula!'
+            )
     @property
     def get_external_url(self) -> list:
         """
@@ -208,7 +375,7 @@ class Lecture:
         Returns:
             list: Uma lista contendo os links externos.
         """
-        return self.__asset.get('external_url')
+        return self.__asset.get('external_url',[])
 
     @property
     def get_media_license_token(self) -> str:
@@ -218,7 +385,7 @@ class Lecture:
         Returns:
             str: O token de acesso à aula.
         """
-        return self.__asset.get('media_license_token')
+        return self.__asset.get('media_license_token','')
 
     def course_is_drmed(self) -> DRM:
         """
@@ -227,12 +394,19 @@ class Lecture:
         Returns:
             DRM: O objeto DRM contendo as keys da aula ou None.
         """
-        try:
-            d = DRM(license_token=self.get_media_license_token,
+        d = DRM(license_token=self.get_media_license_token,
                     get_media_sources=self.get_media_sources)
-            return d
-        except Exception as e:
-            DeprecationWarning(e)
+        return d
+
+    def quiz_object(self) ->Quiz:
+        """se for um quiz ele retorna um objeto Quiz"""
+        if self.get_asset_type.lower() == 'quiz':
+            q =Quiz(get_assessments(lecture_id=self.get_lecture_id,course_id=self.__course_id))
+            return q
+        else:
+            raise UserWarning(
+                'Atenção essa aula não é um Quiz!'
+            )
 
     @property
     def get_download_urls(self) -> list:
@@ -242,7 +416,7 @@ class Lecture:
         Returns:
             list: Uma lista contendo as URLs de download.
         """
-        return self.__asset.get('download_urls')
+        return self.__asset.get('download_urls',[])
 
     @property
     def get_slide_urls(self) -> list:
@@ -252,7 +426,7 @@ class Lecture:
         Returns:
             list: Uma lista contendo as URLs de slides.
         """
-        return self.__asset.get('slide_urls')
+        return self.__asset.get('slide_urls',[])
 
     @property
     def get_slides(self) -> list:
@@ -262,7 +436,7 @@ class Lecture:
         Returns:
             list: Uma lista contendo os slides.
         """
-        return self.__asset.get('slides')
+        return self.__asset.get('slides',[])
 
     @property
     def get_articles(self):
@@ -272,8 +446,11 @@ class Lecture:
         Returns:
             Os artigos relacionados à aula.
         """
-        d = assets_infor(course_id=self.__course_id, id_lecture=self.get_lecture_id, assets_id=self.__asset.get("id"))
-        return d
+        if self.__asset:
+            d = assets_infor(course_id=self.__course_id, id_lecture=self.get_lecture_id, assets_id=self.__asset.get("id"))
+            return d
+        else:
+            return []
 
     @property
     def get_resources(self):
@@ -283,10 +460,12 @@ class Lecture:
         Returns:
             Os recursos adicionais relacionados à aula.
         """
-        files_add = get_files_aule(lecture_id_filter=self.get_lecture_id, data=self.__additional_files)
-        f = Files(files=files_add, id_course=self.__course_id).get_download_url
-        return f
-
+        if self.__additional_files:
+            files_add = get_files_aule(lecture_id_filter=self.get_lecture_id, data=self.__additional_files)
+            f = Files(files=files_add, id_course=self.__course_id).get_download_url
+            return f
+        else:
+            return []
 
 class Course:
     """Recebe um dicionário com os dados do curso."""
@@ -299,8 +478,8 @@ class Course:
             results (dict): Um dicionário contendo os dados do curso.
             course_id (int): O ID do curso.
         """
-        self.__parser_chapers = parser_chapers(results=results)
-        self.__data = self.__parser_chapers
+        self.__parser_chapers = parser_chapters(results=results)
+        self.__data:list = self.__parser_chapers
         self.__course_id = course_id
         self.__results = results
         self.__additional_files_data = get_add_files(course_id)
@@ -375,8 +554,8 @@ class Course:
             int: O número total de lectures no curso.
         """
         total_lectures = 0
-        for chapter in self.__data.values():
-            total_lectures += len(chapter.get('videos_in_chapter', []))
+        for chapter in self.__data:
+            total_lectures += len(chapter.get('lectures', []))
         return total_lectures
 
     @property
@@ -398,39 +577,35 @@ class Course:
             list: Uma lista contendo os títulos de vídeos no curso.
         """
         videos = []
-        for chapter in self.__data.values():
+        for chapter in self.__data:
             for video in chapter.get('videos_in_chapter', []):
-                title = video['video_title']
-                if title != "Files":
-                    videos.append(title)
+                asset_type = video.get('asset_type')
+                if asset_type == 'Video':
+                    title = video['title']
+                    if title != "Files":
+                        videos.append(title)
         return videos
 
     @property
     def get_lectures(self) -> list:
         """
-        Obtém uma lista com todas as aulas.
-
+        Obtém uma lista de dicionários com todas as aulas.
         Returns:
             list: Uma lista contendo todas as aulas.
         """
         videos = []
-        section_order = 1  # Iniciar a numeração das seções (capítulos)
-
-        for chapter in self.__data.values():
-            for index, video in enumerate(chapter.get('videos_in_chapter', [])):
-                section = f"{chapter.get('title_chapter')}"  # Adicionar numeração da Sessão
-                title = video.get('video_title')
-                id_lecture = video.get('lecture_id')
-                id_asset = video.get('asset_id')
+
+        for chapter in self.__data:
+            for video in chapter.get('lectures', []):
                 dt = {
-                    'section': section,
-                    'title': title,
-                    'lecture_id': id_lecture,
-                    'asset_id': id_asset,
-                    'section_order': section_order
+                    'section': chapter.get('title', ''),
+                    'title': video.get('title', ''),
+                    'lecture_id': video.get('lecture_id', ''),
+                    'asset_id': video.get('asset_id', ''),
+                    'asset_type': video.get('asset_type', '')
                 }
                 videos.append(dt)
-            section_order += 1  # Incrementar o número da Sessão após processar os vídeos do capítulo
+
         return videos
 
     def get_details_lecture(self, lecture_id: int) -> Lecture:
@@ -443,7 +618,19 @@ class Course:
         Returns:
             Lecture: Um objeto Lecture contendo os detalhes da aula.
         """
-        links = get_links(course_id=self.__course_id, id_lecture=lecture_id)
+        type_lecture  = ''
+        links= {}
+        if not is_lecture_in_course(lecture_id=lecture_id,lectures=self.get_lectures):
+            raise FileNotFoundError(
+                'Essa aula não existe nesse curso!'
+            )
+        for l in self.get_lectures:
+            if lecture_id == l.get('lecture_id'):
+                type_lecture = l.get('asset_type')
+        if type_lecture.lower() ==  'video' or type_lecture.lower() == 'article':
+            links = get_links(course_id=self.__course_id, id_lecture=lecture_id)
+        else:
+            links = get_assessments(course_id=self.__course_id,lecture_id=lecture_id)
         additional_files = self.__load_assets()
         lecture = Lecture(data=links, course_id=self.__course_id, additional_files=additional_files)
         return lecture

udemy_userAPI/sections.py

@@ -84,7 +84,8 @@ def get_details_courses(course_id):
         resposta = json.loads(response.text)
         return resposta
     else:
-        raise UdemyUserApiExceptions(f"Erro ao obter detalhes do curso! Código de status: {response.status_code}")
+        raise UdemyUserApiExceptions(
+            response.text)
 
 
 def get_course_infor(course_id):

udemy_userAPI/udemy.py

@@ -19,9 +19,6 @@ class Udemy:
             LoginException: Se a sessão estiver expirada.
         """
         self.__headers = HEADERS_USER
-        if not verif_login:
-            raise LoginException("Sessão expirada!")
-
     @staticmethod
     def my_subscribed_courses_by_plan() -> list[dict]:
         """
@@ -33,6 +30,10 @@ class Udemy:
         Raises:
             UdemyUserApiExceptions: Se houver erro ao obter os cursos.
         """
+        if not verif_login:
+            raise LoginException(
+                                 "Nenhuma sessão ativa,primeiro efetue login!")
+
         try:
             courses = get_courses_plan(tipe='plan')
             return courses
@@ -50,6 +51,10 @@ class Udemy:
         Raises:
             UdemyUserApiExceptions: Se houver erro ao obter os cursos.
         """
+        if not verif_login:
+            raise LoginException(
+                "Nenhuma sessão ativa,primeiro efetue login!")
+
         try:
             # Obtém os cursos
             courses1 = get_courses_plan(tipe='default')  # lista de cursos padrão
@@ -72,7 +77,7 @@ class Udemy:
             raise UnhandledExceptions(e)
 
     @staticmethod
-    def get_details_course(course_id):
+    def get_details_course(course_id) ->Course:
         """
         Obtém detalhes de um curso através do ID.
 
@@ -85,6 +90,10 @@ class Udemy:
         Raises:
             UnhandledExceptions: Se houver erro ao obter os detalhes do curso.
         """
+        if not verif_login:
+            raise LoginException(
+                                 "Nenhuma sessão ativa,primeiro efetue login!")
+
         try:
             d = get_details_courses(course_id)
             b = Course(course_id=course_id, results=d)

{udemy_userAPI-0.3.5.dist-info → udemy_userAPI-0.3.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: udemy_userAPI
-Version: 0.3.5
+Version: 0.3.7
 Summary: Obtenha detalhes de cursos que o usuário esteja inscrito da plataforma Udemy,usando o EndPoint de usuário o mesmo que o navegador utiliza para acessar e redenrizar os cursos.
 Author: PauloCesar-dev404
 Author-email: paulocesar0073dev404@gmail.com
@@ -15,11 +15,21 @@ License-File: LICENSE
 Requires-Dist: requests
 Requires-Dist: cloudscraper
 Requires-Dist: pywidevine
+Dynamic: author
+Dynamic: author-email
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: keywords
+Dynamic: license
+Dynamic: platform
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: summary
 
 # udemy-userAPI
 
 
-![Versão](https://img.shields.io/badge/version-0.3.5-orange)
+![Versão](https://img.shields.io/badge/version-0.3.7-orange)
 ![Licença](https://img.shields.io/badge/license-MIT-orange)
 [![Sponsor](https://img.shields.io/badge/💲Donate-yellow)](https://paulocesar-dev404.github.io/me-apoiando-online/)
 [![Sponsor](https://img.shields.io/badge/Documentation-green)](https://github.com/PauloCesar-dev404/udemy-userAPI/blob/main/docs/iniciando.md)

udemy_userAPI-0.3.7.dist-info/RECORD

@@ -0,0 +1,17 @@
+udemy_userAPI/__init__.py,sha256=BPle89xE_CMTKKe_Lw6jioYLgpH-q_Lpho2S-n1PIUA,206
+udemy_userAPI/__version__.py,sha256=ZlJ4BqU7L0jruy2h0iTeuMxcPub8qGB7jbO8vbwvXbY,405
+udemy_userAPI/api.py,sha256=jWWwJBYS9dJDjlozUj4Yi4uc8OCAy5PILqUiRWZMiq8,28153
+udemy_userAPI/authenticate.py,sha256=IJRrCjmhe_x40CrQ2KrOMNP8VvotZf0QMWsrbcLl_rw,14225
+udemy_userAPI/bultins.py,sha256=s12tXjbZgyKAnYrEtZxUzuTY-aIINXlm4mpbxR-r4Io,21932
+udemy_userAPI/exeptions.py,sha256=kfnPdZpqYY8nd0gnl6_Vh-MIz-XupmmbRPIuFnyXupk,692
+udemy_userAPI/sections.py,sha256=eRjUUlEApwrwlcCs9GWIk580qq1UVFqR5RmOgP6y65E,5424
+udemy_userAPI/udemy.py,sha256=AAXc24iAtFTyDyVehhFeSx9CyhWMeFWsbYn1J80TgFw,3270
+udemy_userAPI/.cache/.udemy_userAPI,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+udemy_userAPI/mpd_analyzer/__init__.py,sha256=i3JVWyvcFLaj5kPmx8c1PgjsLht7OUIQQClD4yqYbo8,102
+udemy_userAPI/mpd_analyzer/bin.wvd,sha256=1rAJdCc120hQlX9qe5KUS628eY2ZHYxQSmyhGNefSzo,2956
+udemy_userAPI/mpd_analyzer/mpd_parser.py,sha256=PgUkHc5x8FTuXFCuYkWPZr9TaO_nsKalb02EFYl_zeA,8926
+udemy_userAPI-0.3.7.dist-info/LICENSE,sha256=l4jdKYt8gSdDFOGr09vCKnMn_Im55XIcQKqTDEtFfNs,1095
+udemy_userAPI-0.3.7.dist-info/METADATA,sha256=B5tTj-p8_9DEWwgarUotK9gTteg6teb_R5oeLg7HznQ,1655
+udemy_userAPI-0.3.7.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+udemy_userAPI-0.3.7.dist-info/top_level.txt,sha256=ijTINaSDRKhdahY_X7dmSRFTxBIwQErWv9ATCG55mog,14
+udemy_userAPI-0.3.7.dist-info/RECORD,,

{udemy_userAPI-0.3.5.dist-info → udemy_userAPI-0.3.7.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.6.0)
+Generator: setuptools (75.8.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

animation_consoles/__init__.py

@@ -1 +0,0 @@
-from .animation import  AnimationConsole

animation_consoles/animation.py

@@ -1,64 +0,0 @@
-import sys
-import time
-import threading
-from colorama import init, Fore, Style
-
-# Inicializa o suporte a cores no Windows
-init(autoreset=True)
-
-
-class AnimationConsole:
-    def __init__(self, text="Loading", color=Fore.GREEN, color_frame=Fore.BLUE):
-        """
-        Cria uma animação de loading com uma mensagem colorida no console.
-        :param text: Texto inicial da mensagem de loading.
-        :param color: Cor do texto, usando Fore do colorama.
-        """
-        self._color_frame = color_frame
-        self._text = text
-        self._color = color
-        self._running = False
-        self._animation_thread = None
-        self._frames = ["-", "\\", "|", "/"]
-        self._index = 0
-
-    def start(self):
-        """
-        Inicia a animação no console.
-        """
-        if self._running:
-            return  # Previne múltiplas execuções
-        self._running = True
-        self._animation_thread = threading.Thread(target=self._animate, daemon=True)
-        self._animation_thread.start()
-
-    def stop(self):
-        """
-        Para a animação no console.
-        """
-        self._running = False
-        if self._animation_thread:
-            self._animation_thread.join()
-        sys.stdout.write("\r" + " " * (len(self._text) + 20) + "\r")  # Limpa a linha
-
-    def update_message(self, new_text, new_color=None):
-        """
-        Atualiza a mensagem exibida junto à animação.
-        :param new_text: Novo texto a ser exibido.
-        :param new_color: Nova cor para o texto (opcional).
-        """
-        self._text = new_text
-        if new_color:
-            self._color = new_color
-
-    def _animate(self):
-        """
-        Animação interna do console.
-        """
-        while self._running:
-            frame = self._frames[self._index]
-            self._index = (self._index + 1) % len(self._frames)
-            sys.stdout.write(
-                f"\r{self._color}{self._text}{Style.RESET_ALL} {self._color_frame}{frame}{Style.RESET_ALL}")
-            sys.stdout.flush()
-            time.sleep(0.1)