apsat-core 1.0.0__py3-none-any.whl

apsat_core/__init__.py

@@ -0,0 +1,2 @@
+def main() -> None:
+    print("Hello from apsat-core!")

apsat_core/consts.py

@@ -0,0 +1,13 @@
+# Apsat  Copyright (C) 2026  Deswatts<Deswatts_Cre@outlook.com>
+# This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+# This is free software, and you are welcome to redistribute it
+# under certain conditions; type `show c' for details.
+
+__all__ = ["TYPE_CAPE", "TYPE_MICROSOFT", "TYPE_PROFILE", "TYPE_SKIN", "TYPE_YGGDRASIL"]
+
+
+TYPE_YGGDRASIL = int("00010", 2)  # 2
+TYPE_MICROSOFT = int("00001", 2)  # 1
+TYPE_SKIN = int("00100", 2)  # 4
+TYPE_CAPE = int("01000", 2)  # 8
+TYPE_PROFILE = int("10000", 2)  # 16

apsat_core/download.py

@@ -0,0 +1,136 @@
+# Apsat  Copyright (C) 2026  Deswatts<Deswatts_Cre@outlook.com>
+# This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+# This is free software, and you are welcome to redistribute it
+# under certain conditions; type `show c' for details.
+
+
+import hashlib
+import math
+import os
+import threading
+
+import requests
+
+from deswatts_tools import logutil
+
+logger = logutil.setup_logger(__name__)
+
+
+class DownloadEngine:
+    def __init__(self, download_list: list, download_thread: int = 8):
+        """
+        Multi thread download engine
+
+        :param download_list: Download task list
+        :param download_thread: Max thread count
+        :raises ValueError: When you call some unsupport hash type(exam: md5)
+
+        Param download_list example:
+
+        .. code:: json
+
+            [
+                {
+                    "filename": "example.png",
+                    "url": "https://example.com/example.png",
+                    "sha256": "add0613512f1b7f485f3fe445ae0bfcd344293dbea23e4bf2f999e0f97b80176"
+                },
+                ...
+            ]
+        """
+        super().__init__()
+
+        if not download_list:
+            raise ValueError("The param download_list is Empty")
+
+        download_list_tmp = download_list
+        downloads = []
+        for i in range(math.ceil(len(download_list) / download_thread)):
+            if len(download_list_tmp) == 0:
+                break
+
+            downloads.append(download_list_tmp[0:download_thread])
+            for j in range(download_thread):
+                try:
+                    download_list_tmp.pop(0)
+                except IndexError:
+                    break
+
+        threads = []
+        for i in range(len(downloads)):
+            threads.append(
+                threading.Thread(
+                    target=self.download_unit, name=f"Download-{i}", args=[downloads[i]]
+                )
+            )
+        for i in threads:
+            i.start()
+        for i in threads:
+            i.join()
+
+    @staticmethod
+    def download_unit(download_list: list):
+        for i in download_list:
+            if "sha256" in i:
+                check = DownloadEngine.check_sha256(i)
+            elif "sha1" in i:
+                check = DownloadEngine.check_sha1(i)
+            else:
+                raise ValueError("Unsupport hash type")
+
+            url = i["url"]
+            filename = i["file_name"] if "file_name" in i else i["filename"]
+
+            if not check:
+                with requests.get(url, stream=True) as r:
+                    r.raise_for_status()
+                    with open(filename, "wb") as f:
+                        f.writelines(r.iter_content(chunk_size=4096))
+
+                logger.info(f"Downloaded: {os.path.abspath(filename)}")
+            else:
+                logger.info(f"{os.path.abspath(filename)} is exists")
+
+    @staticmethod
+    def check_sha256(task: dict[str, str]):
+        filename = task["file_name"] if "file_name" in task else task["filename"]
+        target_sha256 = task["sha256"]
+
+        if not os.path.exists(filename):
+            return False
+        if filename is os.PathLike:
+            filename = str(filename)
+
+        file_hash = hashlib.sha256()
+
+        with open(filename, "rb+") as f:
+            while True:
+                tmp = f.read(4096)
+                if tmp == b"":
+                    break
+
+                file_hash.update(tmp)
+
+        return file_hash.hexdigest() == target_sha256
+
+    @staticmethod
+    def check_sha1(task: dict[str, str]):
+        filename = task["file_name"]
+        target_sha1 = task["sha1"]
+
+        if not os.path.exists(filename):
+            return False
+        if filename is os.PathLike:
+            filename = str(filename)
+
+        file_hash = hashlib.sha1()
+
+        with open(filename, "rb+") as f:
+            while True:
+                tmp = f.read(4096)
+                if tmp == b"":
+                    break
+
+                file_hash.update(tmp)
+
+        return file_hash.hexdigest() == target_sha1

apsat_core/exceptions.py

@@ -0,0 +1,19 @@
+# Apsat  Copyright (C) 2026  Deswatts<Deswatts_Cre@outlook.com>
+# This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+# This is free software, and you are welcome to redistribute it
+# under certain conditions; type `show c' for details.
+
+
+class ProfileException(Exception):
+    def __init__(self, *args: object):
+        super().__init__(*args)
+
+
+class ProfileHasNotCustomSkin(ProfileException):
+    def __init__(self):
+        super().__init__("The Profile dose not have any custom skin!")
+
+
+class ProfileHasNotCustomCape(ProfileException):
+    def __init__(self):
+        super().__init__("The Profile dose not have any custom cape!")

apsat_core/get_profile.py

@@ -0,0 +1,158 @@
+# Apsat  Copyright (C) 2026  Deswatts<Deswatts_Cre@outlook.com>
+# This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+# This is free software, and you are welcome to redistribute it
+# under certain conditions; type `show c' for details.
+
+
+import os.path
+import re
+
+import requests
+import urllib3
+
+from apsat_core import consts, get_profile_microsoft, get_profile_yggdrasil
+from apsat_core.exceptions import ProfileHasNotCustomCape, ProfileHasNotCustomSkin
+from apsat_core.types import (
+    NameList,
+    ProfileList,
+    ProfileType,
+    TextureUrlList,
+)
+from deswatts_tools import logutil
+
+logger = logutil.setup_logger(__name__)
+check_url_pattern = re.compile(r"http(s?)://")
+
+
+def _yggdrasil_profile(url: str, names: NameList):
+    return get_profile_yggdrasil.get_profile_yggdrasil(names, url)
+
+
+def _microsoft_profile(names: NameList):
+    return get_profile_microsoft.get_profile_microsoft(names)
+
+
+def _get_textures(profiles: ProfileList):
+    return get_profile_microsoft.get_skin(profiles)
+
+
+def resolve_textures(
+    textures: TextureUrlList,
+    type: ProfileType | int,
+    download_dir: str | os.PathLike[str] | os.PathLike[bytes],
+):
+    if type is ProfileType:
+        type = int(type.type, 2)
+    if download_dir is os.PathLike:
+        download_dir = str(download_dir)
+    result = []
+    for i in textures:
+        if type & consts.TYPE_SKIN == consts.TYPE_SKIN:
+            if i["skin_url"] is None:
+                raise ProfileHasNotCustomSkin
+
+            result.append(
+                {
+                    "filename": os.path.join(
+                        download_dir, i["profile_name"] + "-skin.png"
+                    ),
+                    "url": i["skin_url"]["url"],
+                    "sha256": os.path.basename(
+                        urllib3.util.url.parse_url(i["skin_url"]["url"]).path
+                    ),
+                }
+            )
+        elif type & consts.TYPE_CAPE == consts.TYPE_CAPE:
+            if i["cape_url"] is None:
+                raise ProfileHasNotCustomCape
+
+            result.append(
+                {
+                    "filename": os.path.join(
+                        download_dir, i["profile_name"] + "-cape.png"
+                    ),
+                    "url": i["cape_url"]["url"],
+                    "sha256": os.path.basename(
+                        urllib3.util.url.parse_url(i["cape_url"]["url"]).path
+                    ),
+                }
+            )
+
+    try:
+        os.mkdir(download_dir)
+    except FileExistsError:
+        pass
+
+    logger.info(f"Resolve the textures: {result}")
+
+    return result
+
+
+def _to_absolute_url(url: str, base: str):
+    """
+    This funtion returns absolute url
+    :param url: target url
+    :param base: base url
+    :return: absolute url
+    """
+
+    if re.match(check_url_pattern, url) is not None:
+        return url
+    if url[0] == '/' and base[-1] == '/':
+        base = base[1:]
+    elif url[0] != '/' and base[-1] != '/':
+        url += '/'
+    return base + url
+
+
+def _resolve_api_url(source_url: str):
+    """
+    This function returns real api url
+    :param source_url: url from user input
+    :return: api url
+    """
+
+    check_url = re.match(check_url_pattern, source_url)
+    if check_url is None:
+        source_url = "https://" + source_url
+
+    response = requests.get(source_url)
+    if "x-authlib-injector-api-location" in response.headers:
+        new_url = _to_absolute_url(response.headers["x-authlib-injector-api-location"], source_url)
+        if new_url != source_url:
+            return new_url
+
+    return source_url
+
+
+def get_profile(
+    mode: ProfileType | int, names: NameList, url: str | None = None
+) -> TextureUrlList | ProfileList | None:
+    if mode is ProfileType:
+        mode = int(mode.type, 2)
+
+    if (url is None) and (mode & consts.TYPE_YGGDRASIL == consts.TYPE_YGGDRASIL):
+        raise ValueError("Missing url")
+
+    if mode & consts.TYPE_YGGDRASIL == consts.TYPE_YGGDRASIL:
+        url = _resolve_api_url(url)
+
+    profiles = (
+        _yggdrasil_profile(url, names)
+        if mode & consts.TYPE_YGGDRASIL == consts.TYPE_YGGDRASIL
+        else _microsoft_profile(names)
+    )
+
+    logger.info(f"Got profiles: {profiles}")
+
+    if mode & consts.TYPE_PROFILE == consts.TYPE_PROFILE:
+        textures = profiles
+    else:
+        textures = _get_textures(profiles)
+        logger.info(f"Got textures: {textures}")
+
+    return textures
+
+
+if __name__ == '__main__':
+    print(get_profile(1, NameList(["a"]), ""))

apsat_core/get_profile_microsoft.py

@@ -0,0 +1,87 @@
+# Apsat  Copyright (C) 2026  Deswatts<Deswatts_Cre@outlook.com>
+# This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+# This is free software, and you are welcome to redistribute it
+# under certain conditions; type `show c' for details.
+
+
+import json
+import re
+from base64 import b64decode
+
+import requests
+
+from apsat_core.types import (
+    NameList,
+    ProfileList,
+    TextureList,
+    TextureUrlList,
+    TextureUrls,
+    Url,
+    UUIDList,
+)
+
+_get_uuids_url = "https://api.mojang.com/profiles/minecraft"
+_get_profiles_url = (
+    "https://sessionserver.mojang.com/session/minecraft/profile/<UUID>?unsigned=false"
+)
+
+_replace_get_profiles_url_pattern = re.compile(r"<UUID>")
+
+
+def _get_uuids(profile_names: NameList) -> UUIDList:
+    request_data = profile_names
+
+    request_header = {"Content-Type": "application/json"}
+
+    r = requests.post(_get_uuids_url, json=request_data, headers=request_header)
+    return r.json()
+
+
+def _get_profiles(uuids: UUIDList):
+    result = ProfileList()
+    for i in uuids:
+        url = re.sub(_replace_get_profiles_url_pattern, i["id"], _get_profiles_url)
+        r = requests.get(url)
+        result.append(r.json())
+    return result
+
+
+def _resolve_profiles(profiles: ProfileList):
+    result = TextureList()
+    for i in profiles:
+        for j in i["properties"]:
+            texture = json.loads(b64decode(j["value"]))
+            result.append(texture)
+
+    return result
+
+
+def _resolve_texture(textures: TextureList):
+    result = TextureUrlList()
+    for i in textures:
+        tmp_skin = None
+        tmp_cape = None
+        if "SKIN" in i["textures"]:
+            tmp_skin = Url(name="skin", url=i["textures"]["SKIN"]["url"])
+        if "CAPE" in i["textures"]:
+            tmp_cape = Url(name="cape", url=i["textures"]["CAPE"]["url"])
+
+        tmp = TextureUrls(
+            skin_url=tmp_skin, cape_url=tmp_cape, profile_name=i["profileName"]
+        )
+        result.append(tmp)
+    return result
+
+
+def get_profile_microsoft(profile_names: NameList):
+    uuids = _get_uuids(profile_names)
+    profiles = _get_profiles(uuids)
+
+    return profiles
+
+
+def get_skin(profiles: ProfileList):
+    textures = _resolve_profiles(profiles)
+    urls = _resolve_texture(textures)
+
+    return urls

apsat_core/get_profile_yggdrasil.py

@@ -0,0 +1,93 @@
+# Apsat  Copyright (C) 2026  Deswatts<Deswatts_Cre@outlook.com>
+# This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+# This is free software, and you are welcome to redistribute it
+# under certain conditions; type `show c' for details.
+
+
+import json
+import re
+from base64 import b64decode
+
+import requests
+
+from apsat_core.types import (
+    NameList,
+    ProfileList,
+    TextureList,
+    TextureUrlList,
+    TextureUrls,
+    Url,
+    UUIDList,
+)
+
+_get_uuids_url = "<URL>/api/profiles/minecraft"
+_get_profiles_url = (
+    "<URL>/sessionserver/session/minecraft/profile/<UUID>?unsigned=false"
+)
+
+_replace_get_profiles_url_pattern_uuid = re.compile(r"<UUID>")
+_replace_get_profiles_url_pattern_url = re.compile(r"<URL>")
+
+
+def _get_uuids(profile_names: NameList, url: str) -> UUIDList:
+    request_data = profile_names
+
+    request_header = {"Content-Type": "application/json"}
+
+    url = re.sub(_replace_get_profiles_url_pattern_url, url, _get_uuids_url)
+
+    r = requests.post(url, json=request_data, headers=request_header)
+    return r.json()
+
+
+def _get_profiles(uuids: UUIDList, url: str):
+    result = ProfileList()
+    for i in uuids:
+        finall_url = re.sub(
+            _replace_get_profiles_url_pattern_url, url, _get_profiles_url
+        )
+        finall_url = re.sub(_replace_get_profiles_url_pattern_uuid, i["id"], finall_url)
+        r = requests.get(finall_url)
+        result.append(r.json())
+    return result
+
+
+def _resolve_profiles(profiles: ProfileList):
+    result = TextureList()
+    for i in profiles:
+        for j in i["properties"]:
+            texture = json.loads(b64decode(j["value"]))
+            result.append(texture)
+
+    return result
+
+
+def _resolve_texture(textures: TextureList):
+    result = TextureUrlList()
+    for i in textures:
+        tmp_skin = None
+        tmp_cape = None
+        if "SKIN" in i["textures"]:
+            tmp_skin = Url(name="skin", url=i["textures"]["SKIN"]["url"])
+        if "CAPE" in i["textures"]:
+            tmp_cape = Url(name="cape", url=i["textures"]["CAPE"]["url"])
+
+        tmp = TextureUrls(
+            skin_url=tmp_skin, cape_url=tmp_cape, profile_name=i["profileName"]
+        )
+        result.append(tmp)
+    return result
+
+
+def get_profile_yggdrasil(profile_names: NameList, url: str):
+    uuids = _get_uuids(profile_names, url)
+    profiles = _get_profiles(uuids, url)
+
+    return profiles
+
+
+def get_skin(profiles: ProfileList):
+    textures = _resolve_profiles(profiles)
+    urls = _resolve_texture(textures)
+
+    return urls

apsat_core/types.py

@@ -0,0 +1,94 @@
+# Apsat  Copyright (C) 2026  Deswatts<Deswatts_Cre@outlook.com>
+# This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+# This is free software, and you are welcome to redistribute it
+# under certain conditions; type `show c' for details.
+
+
+from typing import TypedDict
+
+
+class SkinMetadata(TypedDict):
+    model: str | None
+
+
+class SkinObject(TypedDict):
+    url: str
+    model: SkinMetadata | None
+
+
+class CapeObject(TypedDict):
+    url: str
+
+
+class TextureDict(TypedDict):
+    SKIN: SkinObject | None
+    CAPE: CapeObject | None
+
+
+class TextureObject(TypedDict):
+    timestamp: int
+    profileId: str
+    profileName: str
+    signatureRequired: bool | None
+    textures: TextureDict
+
+
+class ProfileProperties(list):
+    name: str
+    signature: str | None
+    value: str
+
+
+class Profile(TypedDict):
+    id: str
+    name: str
+    legacy: bool | None
+    properties: ProfileProperties
+
+
+class Url(TypedDict):
+    name: str
+    url: str
+
+
+class UUIDList(list):
+    uuids: str
+
+
+class NameList(list):
+    names: str
+
+
+class ProfileList(list):
+    profiles: Profile
+
+
+class TextureList(list):
+    texture_objects: TextureObject
+
+
+class TextureUrls(TypedDict):
+    skin_url: Url | None
+    cape_url: Url | None
+    profile_name: str
+
+
+class TextureUrlList(list):
+    urls: TextureUrls
+
+
+class ProfileType(int):
+    type: str
+
+    def __new__(cls, mode):
+        cls.type = cls.to_binary(mode)
+        cls.type = "0" * (5 - len(cls.type)) + cls.type
+        return cls
+
+    @staticmethod
+    def to_binary(mode: str):
+        if int(mode) // 2 == 0:
+            return str(int(mode) % 2)
+        else:
+            tmp = ProfileType.to_binary(str(int(mode) // 2))
+            return tmp + str(int(mode) % 2)

apsat_core/version.py

@@ -0,0 +1,31 @@
+# Apsat  Copyright (C) 2026  Deswatts<Deswatts_Cre@outlook.com>
+# This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+# This is free software, and you are welcome to redistribute it
+# under certain conditions; type `show c' for details.
+
+
+__version__ = "1.0.0"
+__title__ = "Apsat"
+__description__ = "This Package is core of the Apsat"
+__license__ = "GNU GPLv3"
+__author__ = "Deswatts<Deswatts_Cre@outlook.com>"
+__copyright__ = "DeswattsTools  Copyright (C) 2026  Deswatts<Deswatts_Cre@outlook.com>"
+
+
+def get_version() -> dict[str, str]:
+    """
+    此函数用于获取包版本
+    :return: 包版本号
+    """
+    version_digital = ""
+    for i in __version__.split("."):
+        version_digital += i
+    return {"source": __version__, "digital": version_digital}
+
+
+def get_name() -> str:
+    """
+    此函数用于获取包名
+    :return: 包名
+    """
+    return __title__

apsat_core-1.0.0.dist-info/METADATA

@@ -0,0 +1,39 @@
+Metadata-Version: 2.4
+Name: apsat-core
+Version: 1.0.0
+Summary: Core of Apsat
+Keywords: Apsat,core
+Author: Deswatts
+Author-email: Deswatts <Deswatts_Cre@outlook.com>
+License-Expression: GPL-3.0-or-later
+License-File: LICENSE
+Requires-Dist: deswatts-tools>=1.0.0
+Requires-Dist: requests
+Maintainer: Deswatts
+Maintainer-email: Deswatts <Deswatts_Cre@outlook.com>
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+## 简介
+
+- 这是 [Apsat](https://github.com/Deswatts/Apsat) 的核心库
+- 包含了对 Minecraft 账户的一部分功能
+
+## 示例
+
+```python
+# This is a example for get profile from microsoft
+from apsat_core import consts, types, get_profile # Import modules
+
+user_name = "" # Input the profile name
+
+
+if __name__ == '__main__':
+    profile = get_profile.getprofile(
+        types.ProfileType(
+            consts.TYPE_PROFILE | consts.TYPE_MICROSOFT
+        ),
+        user_name
+    ) # Get profile
+    print(profile) # Print result to console
+```

apsat_core-1.0.0.dist-info/RECORD

@@ -0,0 +1,13 @@
+apsat_core/__init__.py,sha256=WxlM_-bGxNgf21CZKHTe3NId-7cFJ1pDV4e7x_fqq2Q,56
+apsat_core/consts.py,sha256=ORG6RJomFhKvp50wsfvIVUBuhR67tso_ew945WfaieU,531
+apsat_core/download.py,sha256=w2uX3p4h9uAQpA8V_pLPnjocuNYkvxHUHKlgc-GfNKY,4029
+apsat_core/exceptions.py,sha256=SklkCj6dE3Ip0m9C-pU33b1b76a16RlFfvQNXNMW1vI,660
+apsat_core/get_profile.py,sha256=YJ1Qwhz9mKsFihiSjSwD3y5nT9oMEu3mhuvvgZ5pXNI,4503
+apsat_core/get_profile_microsoft.py,sha256=T5L93bIr8VSnoc5RkFn3OHiK9dUfKoWF6KhIYKO8bEw,2261
+apsat_core/get_profile_yggdrasil.py,sha256=d_rBd5IJhPXBLM95IhSc_CxJCJYbt4GD5avkmxTgwhs,2533
+apsat_core/types.py,sha256=kmRrrIDcwn_FtUwSqvhnmVqOBbMfwfZZSyueYHRq604,1724
+apsat_core/version.py,sha256=XYFm6g8oiZeu7MnrGyXWDTMiiPC_HfYX19CzFiwIedw,906
+apsat_core-1.0.0.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+apsat_core-1.0.0.dist-info/WHEEL,sha256=-i9oRNYVXXZJUIYl5zclLIg6onEb0NLibTX34uln84w,81
+apsat_core-1.0.0.dist-info/METADATA,sha256=wOMlUl_BrEtGQ2v7YyIc8zJUQBB9FvoVFxBjoEG4QCM,1003
+apsat_core-1.0.0.dist-info/RECORD,,

apsat_core-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.12.13
+Root-Is-Purelib: true
+Tag: py3-none-any