mirror of
https://github.com/remnawave/python-sdk.git
synced 2026-05-14 04:37:15 +00:00
0ed1ce92c0
- Added MetadataController for handling user and node metadata. - Implemented models for user and node metadata management. - Created tests for user and node metadata functionalities. - Enhanced authentication settings with passkey and OAuth2 configurations. - Added bulk actions for node updates and responses. - Refactored existing models to accommodate new features and improve structure. - Removed obsolete test_imports.py file. - Updated environment variables for testing. - Improved error handling in subscription tests. - Added new node plugin functionalities including cloning and execution commands.
128 lines
5 KiB
Markdown
128 lines
5 KiB
Markdown
# Remnawave Python SDK
|
||
|
||
> **📢 Repository Migration Notice**
|
||
>
|
||
> This repository has been moved from [`sm1ky/remnawave-api`](https://github.com/sm1ky/remnawave-api) to [`remnawave/python-sdk`](https://github.com/remnawave/python-sdk).
|
||
>
|
||
> **PyPI Package Migration:**
|
||
> - **Legacy versions (≤1.x)**: Available at [`remnawave_api`](https://pypi.org/project/remnawave_api/) *(deprecated)*
|
||
> - **New versions (≥2.x)**: Available at [`remnawave`](https://pypi.org/project/remnawave/)
|
||
>
|
||
> Please update your dependencies to use the new package name for future updates.
|
||
|
||
[](https://github.com/remnawave/python-sdk/stargazers)
|
||
[](https://github.com/remnawave/python-sdk/network/members)
|
||
[](https://github.com/remnawave/python-sdk/issues)
|
||
[](https://pypi.python.org/pypi/remnawave)
|
||
[](https://pypi.python.org/pypi/remnawave)
|
||
[](https://pypi.python.org/pypi/remnawave)
|
||
[](https://github.com/remnawave/python-sdk/actions/workflows/upload.yml)
|
||
|
||
A Python SDK client for interacting with the **[Remnawave API](https://remna.st)**.
|
||
This library simplifies working with the API by providing convenient controllers, Pydantic models for requests and responses, and fast serialization with `orjson`.
|
||
|
||
## 📦 Installation
|
||
|
||
### New Package (Recommended)
|
||
Install the latest version from the new PyPI package:
|
||
|
||
```bash
|
||
pip install remnawave
|
||
```
|
||
|
||
### Legacy Package (Deprecated)
|
||
If you need older versions (≤1.x), use the legacy package:
|
||
|
||
```bash
|
||
pip install remnawave_api # Deprecated - use 'remnawave' instead
|
||
```
|
||
|
||
### Development Version
|
||
If you need the development version:
|
||
|
||
```bash
|
||
pip install git+https://github.com/remnawave/python-sdk.git@development
|
||
```
|
||
|
||
---
|
||
|
||
## 🫥 Compatible versions
|
||
|
||
| Contract Version | Remnawave Panel Version |
|
||
| ---------------- | ----------------------- |
|
||
| 2.7.0 | >=2.7.0 |
|
||
| 2.6.3 | >=2.6.3 |
|
||
| 2.6.2 | >=2.6.2 |
|
||
| 2.6.1 | >=2.6.0 |
|
||
| 2.4.4 | >=2.4.0 |
|
||
| 2.3.2 | >=2.3.0, <2.4.0 |
|
||
| 2.3.0 | >=2.3.0, <2.3.2 |
|
||
| 2.2.6 | ==2.2.6 |
|
||
| 2.2.3 | >=2.2.13 |
|
||
| 2.1.19 | >=2.1.19, <2.2.0 |
|
||
| 2.1.18 | >=2.1.18 |
|
||
| 2.1.17 | >=2.1.16, <=2.1.17 |
|
||
| 2.1.16 | >=2.1.16 |
|
||
| 2.1.13 | >=2.1.13, <=2.1.15 |
|
||
| 2.1.9 | >=2.1.9, <=2.1.12 |
|
||
| 2.1.8 | ==2.1.8 |
|
||
| 2.1.7.post1 | ==2.1.7 |
|
||
| 2.1.4 | >=2.1.4, <2.1.7 |
|
||
| 2.1.1 | >=2.1.1, <2.1.4 |
|
||
| 2.0.0 | >=2.0.0,<2.1.0 |
|
||
| 1.1.3 | >=1.6.12,<2.0.0 |
|
||
| 1.1.2 | >=1.6.3,<=1.6.11 |
|
||
| 1.1.1 | 1.6.1, 1.6.2 |
|
||
| 1.1.0 | 1.6.0 |
|
||
| 1.0.8 | 1.5.7 |
|
||
|
||
### Dependencies
|
||
- `orjson` (>=3.10.15, <4.0.0)
|
||
- `rapid-api-client` (==0.6.0)
|
||
- `httpx` (>=0.27.2, <0.28.0)
|
||
|
||
## 🚀 Usage
|
||
|
||
Here’s a quick example to get you started:
|
||
|
||
```python
|
||
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())
|
||
```
|
||
|
||
---
|
||
|
||
## ❤️ About
|
||
|
||
This SDK was originally developed by [@kesevone](https://github.com/kesevone) for integration with Remnawave's API.
|
||
|
||
Previously maintained by [@sm1ky](https://github.com/sm1ky) at [`sm1ky/remnawave-api`](https://github.com/sm1ky/remnawave-api).
|
||
|
||
Now officially maintained by the Remnawave Community at [`remnawave/python-sdk`](https://github.com/remnawave/python-sdk).
|