udemy-userAPI 0.3.6__tar.gz → 0.3.7__tar.gz

{udemy_userapi-0.3.6/udemy_userAPI.egg-info → udemy_userapi-0.3.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: udemy_userAPI
-Version: 0.3.6
+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
@@ -29,7 +29,7 @@ Dynamic: summary
 # udemy-userAPI
 
 
-![Versão](https://img.shields.io/badge/version-0.3.6-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.6 → udemy_userapi-0.3.7}/README.md

@@ -3,7 +3,7 @@
   
 
 
-![Versão](https://img.shields.io/badge/version-0.3.6-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.6 → udemy_userapi-0.3.7}/README_PYPI.md

@@ -1,7 +1,7 @@
 # udemy-userAPI
 
 
-![Versão](https://img.shields.io/badge/version-0.3.6-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.6 → udemy_userapi-0.3.7}/udemy_userAPI/__version__.py

@@ -1,4 +1,4 @@
-__version__ = '0.3.6'
+__version__ = '0.3.7'
 __lib_name__ = 'udemy_userAPI'  # local name
 __repo_name__ = 'udemy-userAPI'
 __autor__ = 'PauloCesar-dev404'

{udemy_userapi-0.3.6 → udemy_userapi-0.3.7}/udemy_userAPI/bultins.py

@@ -162,6 +162,115 @@ class 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."""
 
@@ -244,15 +353,20 @@ class Lecture:
         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.
+            Captions: Objeto para gerenciar as legendas.
         """
-        return self.__asset.get('captions',[])
-
+        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:
         """
@@ -475,11 +589,7 @@ class Course:
     @property
     def get_lectures(self) -> list:
         """
-        Obtém uma lista com todas as aulas.
-
-        Args:
-            data (list): Lista de capítulos contendo as aulas.
-
+        Obtém uma lista de dicionários com todas as aulas.
         Returns:
             list: Uma lista contendo todas as aulas.
         """

{udemy_userapi-0.3.6 → udemy_userapi-0.3.7}/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-0.3.6 → udemy_userapi-0.3.7}/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.6 → udemy_userapi-0.3.7/udemy_userAPI.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: udemy_userAPI
-Version: 0.3.6
+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
@@ -29,7 +29,7 @@ Dynamic: summary
 # udemy-userAPI
 
 
-![Versão](https://img.shields.io/badge/version-0.3.6-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)