asiacellclient 1.0.0__tar.gz

asiacellclient-1.0.0/PKG-INFO

@@ -0,0 +1,248 @@
+Metadata-Version: 2.1
+Name: asiacellclient
+Version: 1.0.0
+Summary: Unofficial AsiaCell Python SDK
+Author: KingZero
+Author-email: KingZero@darksidehost.com
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: requests
+Requires-Dist: fake_useragent
+
+# AsiaCell SDK
+
+A modern Python SDK for interacting with AsiaCell APIs.
+
+## Features
+
+- Token-based authentication
+- Profile parsing
+- Balance retrieval
+- Voucher top-up
+- Typed response models
+- Session management
+- Random User-Agent rotation
+- Custom exceptions
+- Lightweight and easy to use
+
+---
+
+# Installation
+
+```bash
+pip install asiacell
+```
+
+---
+
+# Quick Start
+
+```python
+from asiacell import AsiaCellClient
+
+client = AsiaCellClient(
+    token="YOUR_TOKEN"
+)
+
+profile = client.get_profile()
+
+print(profile.name)
+print(profile.phone)
+print(profile.balance.amount)
+```
+
+---
+
+# Authentication
+
+The SDK currently supports Bearer Token authentication.
+
+```python
+from asiacell import AsiaCellClient
+
+client = AsiaCellClient(
+    token="YOUR_JWT_TOKEN"
+)
+```
+
+You can also set or clear the token later:
+
+```python
+client.set_token("TOKEN")
+
+client.clear_token()
+```
+
+---
+
+# Profile
+
+Retrieve account profile information.
+
+```python
+profile = client.get_profile()
+
+print(profile.name)
+print(profile.phone)
+print(profile.photo)
+```
+
+## Profile Object
+
+```python
+profile.name
+profile.phone
+profile.photo
+profile.balance
+```
+
+---
+
+# Balance
+
+```python
+balance = client.get_balance()
+
+print(balance.amount)
+```
+
+---
+
+# Voucher Top-Up
+
+```python
+result = client.topup(
+    msisdn="077XXXXXXXX",
+    voucher="1234567890"
+)
+
+print(result.success)
+print(result.message)
+```
+
+## TopUpResult Object
+
+```python
+result.success
+result.message
+result.raw
+```
+
+---
+
+# Random User-Agent Rotation
+
+```python
+client.rotate_user_agent()
+```
+
+---
+
+# Exceptions
+
+The SDK provides custom exceptions:
+
+```python
+from asiacell.exceptions import (
+    AsiacellError,
+    AuthenticationError,
+    APIError,
+    VoucherUsedError
+)
+```
+
+Example:
+
+```python
+try:
+    client.get_profile()
+
+except AuthenticationError:
+    print("Invalid token")
+
+except APIError as e:
+    print(e)
+```
+
+---
+
+# Models
+
+## Profile
+
+```python
+Profile(
+    name: str,
+    phone: str,
+    photo: str,
+    balance: Balance
+)
+```
+
+## Balance
+
+```python
+Balance(
+    amount: int
+)
+```
+
+## TopUpResult
+
+```python
+TopUpResult(
+    success: bool,
+    message: str,
+    raw: dict
+)
+```
+
+---
+
+# Example
+
+```python
+from asiacell import AsiaCellClient
+
+client = AsiaCellClient(
+    token="YOUR_TOKEN"
+)
+
+profile = client.get_profile()
+
+print(profile.name)
+print(profile.balance.amount)
+
+result = client.topup(
+    msisdn=profile.phone,
+    voucher="1234567890"
+)
+
+print(result.message)
+```
+
+---
+
+# Requirements
+
+- Python 3.9+
+- requests
+- fake-useragent
+
+---
+
+# Legal Disclaimer
+
+This project is an unofficial SDK and is not affiliated with or endorsed by AsiaCell.
+
+Use responsibly and in compliance with applicable terms of service.
+
+---
+
+# License
+
+MIT License

asiacellclient-1.0.0/README.md

@@ -0,0 +1,233 @@
+# AsiaCell SDK
+
+A modern Python SDK for interacting with AsiaCell APIs.
+
+## Features
+
+- Token-based authentication
+- Profile parsing
+- Balance retrieval
+- Voucher top-up
+- Typed response models
+- Session management
+- Random User-Agent rotation
+- Custom exceptions
+- Lightweight and easy to use
+
+---
+
+# Installation
+
+```bash
+pip install asiacell
+```
+
+---
+
+# Quick Start
+
+```python
+from asiacell import AsiaCellClient
+
+client = AsiaCellClient(
+    token="YOUR_TOKEN"
+)
+
+profile = client.get_profile()
+
+print(profile.name)
+print(profile.phone)
+print(profile.balance.amount)
+```
+
+---
+
+# Authentication
+
+The SDK currently supports Bearer Token authentication.
+
+```python
+from asiacell import AsiaCellClient
+
+client = AsiaCellClient(
+    token="YOUR_JWT_TOKEN"
+)
+```
+
+You can also set or clear the token later:
+
+```python
+client.set_token("TOKEN")
+
+client.clear_token()
+```
+
+---
+
+# Profile
+
+Retrieve account profile information.
+
+```python
+profile = client.get_profile()
+
+print(profile.name)
+print(profile.phone)
+print(profile.photo)
+```
+
+## Profile Object
+
+```python
+profile.name
+profile.phone
+profile.photo
+profile.balance
+```
+
+---
+
+# Balance
+
+```python
+balance = client.get_balance()
+
+print(balance.amount)
+```
+
+---
+
+# Voucher Top-Up
+
+```python
+result = client.topup(
+    msisdn="077XXXXXXXX",
+    voucher="1234567890"
+)
+
+print(result.success)
+print(result.message)
+```
+
+## TopUpResult Object
+
+```python
+result.success
+result.message
+result.raw
+```
+
+---
+
+# Random User-Agent Rotation
+
+```python
+client.rotate_user_agent()
+```
+
+---
+
+# Exceptions
+
+The SDK provides custom exceptions:
+
+```python
+from asiacell.exceptions import (
+    AsiacellError,
+    AuthenticationError,
+    APIError,
+    VoucherUsedError
+)
+```
+
+Example:
+
+```python
+try:
+    client.get_profile()
+
+except AuthenticationError:
+    print("Invalid token")
+
+except APIError as e:
+    print(e)
+```
+
+---
+
+# Models
+
+## Profile
+
+```python
+Profile(
+    name: str,
+    phone: str,
+    photo: str,
+    balance: Balance
+)
+```
+
+## Balance
+
+```python
+Balance(
+    amount: int
+)
+```
+
+## TopUpResult
+
+```python
+TopUpResult(
+    success: bool,
+    message: str,
+    raw: dict
+)
+```
+
+---
+
+# Example
+
+```python
+from asiacell import AsiaCellClient
+
+client = AsiaCellClient(
+    token="YOUR_TOKEN"
+)
+
+profile = client.get_profile()
+
+print(profile.name)
+print(profile.balance.amount)
+
+result = client.topup(
+    msisdn=profile.phone,
+    voucher="1234567890"
+)
+
+print(result.message)
+```
+
+---
+
+# Requirements
+
+- Python 3.9+
+- requests
+- fake-useragent
+
+---
+
+# Legal Disclaimer
+
+This project is an unofficial SDK and is not affiliated with or endorsed by AsiaCell.
+
+Use responsibly and in compliance with applicable terms of service.
+
+---
+
+# License
+
+MIT License

asiacellclient-1.0.0/asiacellclient/__init__.py

@@ -0,0 +1,8 @@
+__title__ = 'AsiaCellClient'
+__author__ = '𝗠𝗮𝗛𝗠𝗼𝘂𝗗'
+__copyright__ = 'Copyright (c) 2026 𝗠𝗮𝗛𝗠𝗼𝘂𝗗'
+__version__ = '1.0.0'
+
+from .models import *
+from .exceptions import *
+from .client import *

asiacellclient-1.0.0/asiacellclient/client.py

@@ -0,0 +1,151 @@
+import requests
+from typing import Optional, Dict
+from fake_useragent import UserAgent
+from .models import Profile, Balance, TopUpResult
+from .exceptions import APIError, AuthenticationError, VoucherUsedError
+
+
+class AsiaCellClient:
+    BASE_URL = "https://www.asiacell.com/api/v1"
+
+    def __init__(self, device_id: Optional[str] = None, token: Optional[str] = None, timeout: int = 20):
+        self.device_id = device_id if device_id else self.generate_device_id()
+        self.timeout = timeout
+        self.ua = UserAgent()
+        self.session = requests.Session()
+        if token:
+            self.set_token(token)
+        self.session.headers.update({
+            "Accept": "*/*",
+            "Content-Type": "application/json",
+            "User-Agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36",
+            "DeviceId": self.device_id,
+            "Accept-Language": "ar-EG,ar;q=0.9,en-US;q=0.8,en;q=0.7,ar-AE;q=0.6",
+            "Connection": "keep-alive",
+            "Referer": "https://www.asiacell.com/personal/my-account",
+            "Origin": "https://www.asiacell.com"
+        })
+
+        if self.token:
+            self.session.headers["Authorization"] = f"Bearer {self.token}"
+        self.rotate_user_agent()
+
+    # ======================
+    # Token handling
+    # ======================
+
+    def set_token(self, token: str):
+        self.token = token
+        self.session.headers["Authorization"] = f"Bearer {token}"
+        self.session.get(url="https://www.asiacell.com/personal/my-account?tab=1",timeout=self.timeout)
+
+    def clear_token(self):
+        self.token = None
+        self.session.headers.pop("Authorization", None)
+
+    @property
+    def is_authenticated(self) -> bool:
+        return self.token is not None
+    
+    def generate_device_id(self):
+        import uuid
+        return uuid.uuid4().hex
+    
+    def rotate_user_agent(self):
+        self.session.headers["User-Agent"] = self.ua.random
+    
+    # ======================
+    # Core request
+    # ======================
+
+    def _request(self, method: str, endpoint: str, json: Dict = None):
+        url = f"{self.BASE_URL}{endpoint}"
+        if not self.is_authenticated:
+            raise AuthenticationError("Unauthorized")
+        try:
+            res = self.session.request(
+                method=method,
+                url=url,
+                json=json,
+                timeout=self.timeout
+            )
+
+            data = res.json()
+
+        except Exception as e:
+            raise APIError(f"Request failed: {str(e)}")
+
+        if isinstance(data, dict) and data.get("success") is False:
+            msg = data.get("message", "Unknown error")
+
+            if "voucher has been used" in msg.lower():
+                raise VoucherUsedError(msg)
+
+            if "unauthorized" in msg.lower():
+                raise AuthenticationError(msg)
+
+            raise APIError(msg)
+
+        return data
+
+    # ======================
+    # Profile
+    # ======================
+
+    def get_profile(self) -> Profile:
+        data = self._request("GET", "/profile?lang=ar")
+
+        bodies = data["data"]["bodies"]
+
+        profile_block = next(
+            (b for b in bodies if b.get("type") == "profile"),
+            None
+        )
+
+        item = profile_block["items"][0]
+
+        balance = self.get_balance()
+
+        return Profile(
+            name=item.get("name"),
+            phone=item.get("phoneNumber"),
+            photo=item.get("photo"),
+            balance=balance
+        )
+
+    # ======================
+    # Balance
+    # ======================
+
+    def get_balance(self) -> Balance:
+        data = self._request("GET", "/profile?lang=ar")
+
+        bodies = data["data"]["bodies"]
+
+        balance_block = next(
+            (b for b in bodies if b.get("type") == "balance"),
+            None
+        )
+
+        amount = balance_block["items"][0]["value"]
+
+        return Balance(amount=int(amount))
+
+    # ======================
+    # TopUp
+    # ======================
+
+    def topup(self, msisdn: str, voucher: str, recharge_type: int = 1) -> TopUpResult:
+        payload = {
+            "msisdn": msisdn,
+            "voucher": voucher,
+            "rechargeType": recharge_type
+        }
+
+        data = self._request("POST", "/top-up?lang=ar", json=payload)
+
+        return TopUpResult(
+            success=data.get("success", False),
+            message=data.get("message", ""),
+            raw=data
+        )

asiacellclient-1.0.0/asiacellclient/exceptions.py

@@ -0,0 +1,14 @@
+class AsiacellError(Exception):
+    pass
+
+
+class AuthenticationError(AsiacellError):
+    pass
+
+
+class APIError(AsiacellError):
+    pass
+
+
+class VoucherUsedError(AsiacellError):
+    pass

asiacellclient-1.0.0/asiacellclient/models.py

@@ -0,0 +1,27 @@
+from dataclasses import dataclass
+from typing import Optional, Dict
+
+
+@dataclass
+class Balance:
+    amount: int
+
+
+@dataclass
+class Profile:
+    name: str
+    phone: str
+    photo: str
+
+    balance: Optional[Balance] = None
+
+
+@dataclass
+class TopUpResult:
+    success: bool
+    message: str
+    raw: Optional[Dict] = None
+
+    @property
+    def is_success(self) -> bool:
+        return self.success

asiacellclient-1.0.0/asiacellclient.egg-info/PKG-INFO

@@ -0,0 +1,248 @@
+Metadata-Version: 2.1
+Name: asiacellclient
+Version: 1.0.0
+Summary: Unofficial AsiaCell Python SDK
+Author: KingZero
+Author-email: KingZero@darksidehost.com
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: requests
+Requires-Dist: fake_useragent
+
+# AsiaCell SDK
+
+A modern Python SDK for interacting with AsiaCell APIs.
+
+## Features
+
+- Token-based authentication
+- Profile parsing
+- Balance retrieval
+- Voucher top-up
+- Typed response models
+- Session management
+- Random User-Agent rotation
+- Custom exceptions
+- Lightweight and easy to use
+
+---
+
+# Installation
+
+```bash
+pip install asiacell
+```
+
+---
+
+# Quick Start
+
+```python
+from asiacell import AsiaCellClient
+
+client = AsiaCellClient(
+    token="YOUR_TOKEN"
+)
+
+profile = client.get_profile()
+
+print(profile.name)
+print(profile.phone)
+print(profile.balance.amount)
+```
+
+---
+
+# Authentication
+
+The SDK currently supports Bearer Token authentication.
+
+```python
+from asiacell import AsiaCellClient
+
+client = AsiaCellClient(
+    token="YOUR_JWT_TOKEN"
+)
+```
+
+You can also set or clear the token later:
+
+```python
+client.set_token("TOKEN")
+
+client.clear_token()
+```
+
+---
+
+# Profile
+
+Retrieve account profile information.
+
+```python
+profile = client.get_profile()
+
+print(profile.name)
+print(profile.phone)
+print(profile.photo)
+```
+
+## Profile Object
+
+```python
+profile.name
+profile.phone
+profile.photo
+profile.balance
+```
+
+---
+
+# Balance
+
+```python
+balance = client.get_balance()
+
+print(balance.amount)
+```
+
+---
+
+# Voucher Top-Up
+
+```python
+result = client.topup(
+    msisdn="077XXXXXXXX",
+    voucher="1234567890"
+)
+
+print(result.success)
+print(result.message)
+```
+
+## TopUpResult Object
+
+```python
+result.success
+result.message
+result.raw
+```
+
+---
+
+# Random User-Agent Rotation
+
+```python
+client.rotate_user_agent()
+```
+
+---
+
+# Exceptions
+
+The SDK provides custom exceptions:
+
+```python
+from asiacell.exceptions import (
+    AsiacellError,
+    AuthenticationError,
+    APIError,
+    VoucherUsedError
+)
+```
+
+Example:
+
+```python
+try:
+    client.get_profile()
+
+except AuthenticationError:
+    print("Invalid token")
+
+except APIError as e:
+    print(e)
+```
+
+---
+
+# Models
+
+## Profile
+
+```python
+Profile(
+    name: str,
+    phone: str,
+    photo: str,
+    balance: Balance
+)
+```
+
+## Balance
+
+```python
+Balance(
+    amount: int
+)
+```
+
+## TopUpResult
+
+```python
+TopUpResult(
+    success: bool,
+    message: str,
+    raw: dict
+)
+```
+
+---
+
+# Example
+
+```python
+from asiacell import AsiaCellClient
+
+client = AsiaCellClient(
+    token="YOUR_TOKEN"
+)
+
+profile = client.get_profile()
+
+print(profile.name)
+print(profile.balance.amount)
+
+result = client.topup(
+    msisdn=profile.phone,
+    voucher="1234567890"
+)
+
+print(result.message)
+```
+
+---
+
+# Requirements
+
+- Python 3.9+
+- requests
+- fake-useragent
+
+---
+
+# Legal Disclaimer
+
+This project is an unofficial SDK and is not affiliated with or endorsed by AsiaCell.
+
+Use responsibly and in compliance with applicable terms of service.
+
+---
+
+# License
+
+MIT License

asiacellclient-1.0.0/asiacellclient.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+setup.py
+asiacellclient/__init__.py
+asiacellclient/client.py
+asiacellclient/exceptions.py
+asiacellclient/models.py
+asiacellclient.egg-info/PKG-INFO
+asiacellclient.egg-info/SOURCES.txt
+asiacellclient.egg-info/dependency_links.txt
+asiacellclient.egg-info/requires.txt
+asiacellclient.egg-info/top_level.txt

asiacellclient-1.0.0/asiacellclient.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

asiacellclient-1.0.0/asiacellclient.egg-info/requires.txt

@@ -0,0 +1,2 @@
+requests
+fake_useragent

asiacellclient-1.0.0/asiacellclient.egg-info/top_level.txt

@@ -0,0 +1 @@
+asiacellclient

asiacellclient-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

asiacellclient-1.0.0/setup.py

@@ -0,0 +1,23 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="asiacellclient",
+    version="1.0.0",
+    author="KingZero",
+    author_email="KingZero@darksidehost.com",
+    description="Unofficial AsiaCell Python SDK",
+    long_description=open("README.md").read(),
+    long_description_content_type="text/markdown",
+    packages=find_packages(),
+    install_requires=[
+        "requests",
+        "fake_useragent"
+    ],
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+    python_requires='>=3.9',
+    license="MIT"
+)