udemy-userAPI 0.3.2__py3-none-any.whl

udemy_userAPI/bultins.py

@@ -0,0 +1,495 @@
+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 .exeptions import LoginException
+
+
+class DRM:
+    def __init__(self, license_token: str, get_media_sources: list):
+        """
+        Inicializa o objeto DRM.
+
+        Args:
+            license_token (str): O token de licença.
+            get_media_sources (list): A lista de fontes de mídia.
+        """
+        self.__mpd_file_path = None
+        self.__token = license_token
+        self.__dash_url = organize_streams(streams=get_media_sources).get('dash', {})
+        if not license_token or get_media_sources:
+            return
+
+    def get_key_for_lesson(self):
+        """
+        Obtém as chaves para a aula.
+
+        Returns:
+            As chaves da aula ou None se não for possível obtê-las.
+        """
+        try:
+            if self.__dash_url:
+                self.__mpd_file_path = get_mpd_file(mpd_url=self.__dash_url[0].get('src'))
+                parser = MPDParser(mpd_content=self.__mpd_file_path)
+                resolutions = get_highest_resolution(parser.get_all_video_resolutions())
+                parser.set_selected_resolution(resolution=resolutions)
+                init_url = parser.get_selected_video_init_url()
+                if init_url:
+                    pssh = get_pssh(init_url=init_url)
+                    if pssh:
+                        keys = extract(pssh=pssh, license_token=self.__token)
+                        if keys:
+                            return keys
+                        else:
+                            return None
+                else:
+                    return None
+            else:
+                return None
+        except Exception as e:
+            raise Exception(f"Não foi possível obter as chaves!\n{e}")
+
+
+class Files:
+    def __init__(self, files: list[dict], id_course):
+        """
+        Inicializa o objeto Files.
+
+        Args:
+            files (list[dict]): Lista de dicionários contendo os dados dos arquivos.
+            id_course: ID do curso.
+        """
+        self.__data = files
+        self.__id_course = id_course
+
+    @property
+    def get_download_url(self) -> dict[str, Any | None] | list[dict[str, Any | None]]:
+        """
+        Obtém a URL de download de um arquivo quando disponível.
+
+        Returns:
+            dict[str, Any | None] | list[dict[str, Any | None]]: URL de download do arquivo.
+        """
+        from .authenticate import UdemyAuth
+        auth = UdemyAuth()
+        if not auth.verif_login():
+            raise LoginException("Sessão expirada!")
+        download_urls = []
+        for files in self.__data:
+            lecture_id = files.get('lecture_id', None)
+            asset_id = files.get('asset_id', None)
+            title = files.get("title", None)
+            lecture_title = files.get('lecture_title', None)
+            external_link = files.get('ExternalLink', None)
+            if external_link:
+                lnk = get_external_liks(course_id=self.__id_course, id_lecture=lecture_id, asset_id=asset_id)
+                dt_file = {'title-file': title,
+                           'lecture_title': lecture_title,
+                           'lecture_id': lecture_id,
+                           'external_link': external_link,
+                           'data-file': lnk.get('external_url', None)}
+                return dt_file
+            if asset_id and title and lecture_id and not external_link:
+                resp = requests.get(
+                    f"https://www.udemy.com/api-2.0/users/me/subscribed-courses/{self.__id_course}/lectures/"
+                    f"{lecture_id}/supplementary-assets/{asset_id}/?fields[asset]=download_urls",
+                    headers=HEADERS_USER)
+                if resp.status_code == 200:
+                    da = json.loads(resp.text)
+                    # Para cada dict de um arquivo colocar seu título:
+                    dt_file = {'title-file': title,
+                               'lecture_title': lecture_title,
+                               'lecture_id': lecture_id,
+                               'external_link': external_link,
+                               'data-file': da['download_urls']}
+                    download_urls.append(dt_file)
+        return download_urls
+
+
+class Lecture:
+    """Cria objetos aula (lecture) do curso e extrai os dados."""
+
+    def __init__(self, data: dict, course_id: int, additional_files):
+        """
+        Inicializa o objeto Lecture.
+
+        Args:
+            data (dict): Um dicionário contendo os dados da aula.
+            course_id (int): O ID do curso.
+            additional_files: Arquivos adicionais relacionados à aula.
+        """
+        self.__course_id = course_id
+        self.__data = data
+        self.__additional_files = additional_files
+        self.__asset = self.__data.get("asset", {})
+
+    @property
+    def get_lecture_id(self) -> int:
+        """
+        Obtém o ID da aula.
+
+        Returns:
+            int: O ID da aula.
+        """
+        return self.__data.get('id', 0)
+
+    @property
+    def get_description(self) -> str:
+        """
+        Obtém a descrição da aula.
+
+        Returns:
+            str: A descrição da aula.
+        """
+        return remove_tag(str(self.__data.get('description')))
+
+    @property
+    def is_free(self) -> bool:
+        """
+        Verifica se a aula é gratuita (aulas gratuitas estão disponíveis na apresentação do curso).
+
+        Returns:
+            bool: True se a aula for gratuita, False caso contrário.
+        """
+        return self.__data.get('is_free', False)
+
+    @property
+    def get_thumbnail(self) -> dict:
+        """
+        Obtém informações da miniatura (thumbnail) do vídeo.
+
+        Returns:
+            dict: Um dicionário contendo as URLs das miniaturas.
+        """
+        thumbnail_sprite = self.__asset.get('thumbnail_sprite', {})
+        return {
+            'thumbnail_vtt_url': thumbnail_sprite.get('vtt_url'),
+            'thumbnail_img_url': thumbnail_sprite.get('img_url')
+        }
+
+    @property
+    def get_asset_type(self) -> str:
+        """
+        Obtém o tipo de asset (Video, Article, etc.).
+
+        Returns:
+            str: O tipo de asset.
+        """
+        return self.__asset.get('asset_type', 'Undefined')
+
+    @property
+    def get_media_sources(self) -> list:
+        """
+        Obtém dados de streaming.
+
+        Returns:
+            list: Uma lista contendo as fontes de mídia.
+        """
+        return self.__asset.get('media_sources')
+
+    @property
+    def get_captions(self) -> list:
+        """
+        Obtém as legendas.
+
+        Returns:
+            list: Uma lista contendo as legendas.
+        """
+        return self.__asset.get('captions')
+
+    @property
+    def get_external_url(self) -> list:
+        """
+        Obtém links externos se houver.
+
+        Returns:
+            list: Uma lista contendo os links externos.
+        """
+        return self.__asset.get('external_url')
+
+    @property
+    def get_media_license_token(self) -> str:
+        """
+        Obtém o token de acesso à aula se houver.
+
+        Returns:
+            str: O token de acesso à aula.
+        """
+        return self.__asset.get('media_license_token')
+
+    def course_is_drmed(self) -> DRM:
+        """
+        Verifica se a aula possui DRM. Se sim, retorna as keys da aula.
+
+        Returns:
+            DRM: O objeto DRM contendo as keys da aula ou None.
+        """
+        try:
+            d = DRM(license_token=self.get_media_license_token,
+                    get_media_sources=self.get_media_sources)
+            return d
+        except Exception as e:
+            DeprecationWarning(e)
+
+    @property
+    def get_download_urls(self) -> list:
+        """
+        Obtém URLs de download se houver.
+
+        Returns:
+            list: Uma lista contendo as URLs de download.
+        """
+        return self.__asset.get('download_urls')
+
+    @property
+    def get_slide_urls(self) -> list:
+        """
+        Obtém URLs de slides se houver.
+
+        Returns:
+            list: Uma lista contendo as URLs de slides.
+        """
+        return self.__asset.get('slide_urls')
+
+    @property
+    def get_slides(self) -> list:
+        """
+        Obtém slides se houver.
+
+        Returns:
+            list: Uma lista contendo os slides.
+        """
+        return self.__asset.get('slides')
+
+    @property
+    def get_articles(self):
+        """
+        Obtém os artigos relacionados à aula.
+
+        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
+
+    @property
+    def get_resources(self):
+        """
+        Obtém os recursos adicionais relacionados à aula.
+
+        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
+
+
+class Course:
+    """Recebe um dicionário com os dados do curso."""
+
+    def __init__(self, results: dict, course_id: int):
+        """
+        Inicializa o objeto Course.
+
+        Args:
+            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.__course_id = course_id
+        self.__results = results
+        self.__additional_files_data = get_add_files(course_id)
+        self.__information = self.__load_infor_course()
+
+    def __load_infor_course(self) -> dict:
+        """
+        Obtém as informações do curso.
+
+        Returns:
+            dict: Um dicionário contendo as informações do curso.
+        """
+        data = get_course_infor(self.__course_id)
+        return data
+
+    @property
+    def title_course(self) -> str:
+        """
+        Obtém o título do curso.
+
+        Returns:
+            str: O título do curso.
+        """
+        return self.__information.get('title')
+
+    @property
+    def instructors(self) -> dict:
+        """
+        Obtém informações dos instrutores.
+
+        Returns:
+            dict: Um dicionário contendo as informações dos instrutores.
+        """
+        return self.__information.get("visible_instructors")
+
+    @property
+    def locale(self):
+        """
+        Obtém informações de localidade do curso.
+
+        Returns:
+            str: As informações de localidade do curso.
+        """
+        return self.__information.get('locale')
+
+    @property
+    def primary_category(self):
+        """
+        Obtém a categoria primária.
+
+        Returns:
+            str: A categoria primária.
+        """
+        return self.__information.get('primary_category')
+
+    @property
+    def primary_subcategory(self):
+        """
+        Obtém a subcategoria primária.
+
+        Returns:
+            str: A subcategoria primária.
+        """
+        return self.__information.get('primary_subcategory')
+
+    @property
+    def count_lectures(self) -> int:
+        """
+        Obtém o número total de lectures no curso.
+
+        Returns:
+            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', []))
+        return total_lectures
+
+    @property
+    def count_chapters(self) -> int:
+        """
+        Obtém o número total de chapters (sections) no curso.
+
+        Returns:
+            int: O número total de chapters (sections) no curso.
+        """
+        return len(self.__data)
+
+    @property
+    def title_videos(self) -> list:
+        """
+        Obtém uma lista com todos os títulos de vídeos no curso.
+
+        Returns:
+            list: Uma lista contendo os títulos de vídeos no curso.
+        """
+        videos = []
+        for chapter in self.__data.values():
+            for video in chapter.get('videos_in_chapter', []):
+                title = video['video_title']
+                if title != "Files":
+                    videos.append(title)
+        return videos
+
+    @property
+    def get_lectures(self) -> list:
+        """
+        Obtém uma lista 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 seção
+                title = video.get('video_title')
+                id_lecture = video.get('lecture_id')
+                id_asset = video.get('asset_id')
+                dt = {
+                    'section': section,
+                    'title': title,
+                    'lecture_id': id_lecture,
+                    'asset_id': id_asset,
+                    'section_order': section_order
+                }
+                videos.append(dt)
+            section_order += 1  # Incrementar o número da seção após processar os vídeos do capítulo
+        return videos
+
+    def get_details_lecture(self, lecture_id: int) -> Lecture:
+        """
+        Obtém detalhes de uma aula específica.
+
+        Args:
+            lecture_id (int): O ID da aula.
+
+        Returns:
+            Lecture: Um objeto Lecture contendo os detalhes da aula.
+        """
+        links = get_links(course_id=self.__course_id, id_lecture=lecture_id)
+        additional_files = self.__load_assets()
+        lecture = Lecture(data=links, course_id=self.__course_id, additional_files=additional_files)
+        return lecture
+
+    @property
+    def get_additional_files(self) -> list:
+        """
+        Retorna a lista de arquivos adicionais de um curso.
+
+        Returns:
+            list: Uma lista contendo os arquivos adicionais de um curso.
+        """
+        supplementary_assets = []
+        for item in self.__additional_files_data.get('results', []):
+            if item.get('_class') == 'lecture':
+                id_l = item.get('id', {})
+                title = item.get('title', {})
+                assets = item.get('supplementary_assets', [])
+                for asset in assets:
+                    supplementary_assets.append({
+                        'lecture_id': id_l,
+                        'lecture_title': title,
+                        'asset': asset
+                    })
+        files = extract_files(supplementary_assets)
+        files_objt = Files(files=files, id_course=self.__course_id).get_download_url
+        return files_objt
+
+    def __load_assets(self):
+        """
+        Retorna a lista de arquivos adicionais de um curso.
+
+        Returns:
+            list: Uma lista contendo os arquivos adicionais de um curso.
+        """
+        supplementary_assets = []
+        for item in self.__additional_files_data.get('results', []):
+            if item.get('_class') == 'lecture':
+                id_l = item.get('id')
+                title = item.get('title')
+                assets = item.get('supplementary_assets', [])
+                for asset in assets:
+                    supplementary_assets.append({
+                        'lecture_id': id_l,
+                        'lecture_title': title,
+                        'asset': asset
+                    })
+        files = extract_files(supplementary_assets)
+        return files

udemy_userAPI/exeptions.py

@@ -0,0 +1,22 @@
+class UdemyUserApiExceptions(Exception):
+    def __init__(self, message="Udemy_UserApi Generic Error!"):
+        self.message = message
+        super().__init__(self.message)
+
+
+class Upstreamconnecterror(Exception):
+    def __init__(self, message="Falha na conexão com o servidor!"):
+        self.message = message
+        super().__init__(self.message)
+
+
+class UnhandledExceptions(Exception):
+    def __init__(self, message="Error Unhandled!"):
+        self.message = message
+        super().__init__(self.message)
+
+
+class LoginException(Exception):
+    def __init__(self, message="Error Login!"):
+        self.message = message
+        super().__init__(self.message)

udemy_userAPI/mpd_analyzer/__init__.py

@@ -0,0 +1,3 @@
+# Biblioteca para análise de arquivos MPD
+from .mpd_parser import MPDParser
+__version__ = '0.1.0'