إنتقل إلى المحتوى الرئيسي

Python SDK [community]

SDK المجتمع

هذا الـ SDK يُصان بالكامل من قِبل المجتمع.

Remnawave Python SDK هي مكتبة للتفاعل السهل مع أنواع RestAPI.

✨ الميزات الرئيسية

  • تصميم قائم على المتحكمات: تقسيم الوظائف إلى متحكمات منفصلة لمرونة أكبر. استخدم فقط ما تحتاجه!
  • نماذج Pydantic: طلبات واستجابات ذات أنواع قوية لموثوقية أفضل.
  • تسلسل سريع: مدعوم بـ orjson للتعامل الفعّال مع JSON.
  • استخدام معياري: استيراد متحكمات فردية أو الـ SDK الكامل حسب الحاجة.
  • دعم عميل HTTP مخصص: يمكنك تمرير httpx.AsyncClient الخاص بك مع رؤوس مخصصة لتجاوز الفحوصات المختلفة.
  • تكامل رمز Caddy: دعم مباشر لتمرير caddy_token أثناء تهيئة الـ SDK.

التثبيت​

pip install remnawave

الاستخدام​

مثال على الاستخدام
import os
import asyncio

from remnawave import RemnawaveSDK  # Updated import for new package
from remnawave.models import (  # Updated import path
    UsersResponseDto, 
    UserResponseDto,
    GetAllConfigProfilesResponseDto,
    CreateInternalSquadRequestDto
)

async def main():
    # URL to your panel (ex. https://vpn.com or http://127.0.0.1:3000)
    base_url: str = os.getenv("REMNAWAVE_BASE_URL")
    # Bearer Token from panel (section: API Tokens) 
    token: str = os.getenv("REMNAWAVE_TOKEN")

    # Initialize the SDK
    remnawave = RemnawaveSDK(base_url=base_url, token=token)

    # Fetch all users
    response: UsersResponseDto = await remnawave.users.get_all_users()
    total_users: int = response.total
    users: list[UserResponseDto] = response.users
    print("Total users: ", total_users)
    print("List of users: ", users)

if __name__ == "__main__":
    asyncio.run(main())
مثال على الاستخدام مع Caddy كخادم ويب
import os
import asyncio

from remnawave import RemnawaveSDK  # Updated import for new package
from remnawave.models import (  # Updated import path
    UsersResponseDto, 
    UserResponseDto,
    GetAllConfigProfilesResponseDto,
    CreateInternalSquadRequestDto
)

async def main():
    # URL to your panel (ex. https://vpn.com or http://127.0.0.1:3000)
    base_url: str = os.getenv("REMNAWAVE_BASE_URL")
    # Bearer Token from panel (section: API Tokens) 
    token: str = os.getenv("REMNAWAVE_TOKEN")
    # Bearer Token for Caddy Auth
    caddy_token = os.getenv("CADDY_TOKEN_AUTH")

    # Initialize the SDK
    remnawave = RemnawaveSDK(base_url=base_url, token=token, caddy_token=caddy_token)

    # Fetch all users
    response: UsersResponseDto = await remnawave.users.get_all_users()
    total_users: int = response.total
    users: list[UserResponseDto] = response.users
    print("Total users: ", total_users)
    print("List of users: ", users)

if __name__ == "__main__":
    asyncio.run(main())
مثال على الاستخدام مع عميل مخصص
import os
import asyncio
import httpx
from remnawave import RemnawaveSDK

async def main():
    base_url = os.getenv("REMNAWAVE_BASE_URL")
    token = os.getenv("REMNAWAVE_TOKEN")

    # Custom client with headers
    async with httpx.AsyncClient(headers={"hello": "world"}) as client:
        # Initialize SDK with a custom client
        remnawave = RemnawaveSDK(base_url=base_url, token=token, client=client)

        # Fetch all users
        response = await remnawave.users.get_all_users_v2()
        print("Total users:", response.total)

asyncio.run(main())

روابط المشروع​