Skip to main content

gozargah_node_bridge_py

Library to connect and use https://github.com/M03ED/gozargah-node

Usage

pip install gozargah-node-bridge

Library is fully async for both gRPC and REST API connection.

Example

import GozargahNodeBridge as Bridge
# or
import GozargahNodeBridge as GNB

Creating Node

node = Bridge.create_node(
    connection=Bridge.NodeType.GRPC, # GRPC or REST
    address=address, # Node ip address or domain
    port=port, 
    client_cert=client_cert_content, # client side ssl certificate as string
    client_key=client_key_content, # client side ssl key as string
    server_ca=server_ca_content, # server side ssl key as string
    extra={}, # a dictionary to hold node data on production, optional, default: None
    )

Proto Structure

If you need to have access proto structure you can use:

from GozargahNodeBridge.common import service_pb2 as service

Create User

user = Bridge.create_user(
    email="jeff", 
    proxies=Bridge.create_proxy(
        vmess_id="0d59268a-9847-4218-ae09-65308eb52e08", # UUID converted to str
        vless_id="0d59268a-9847-4218-ae09-65308eb52e08", # UUID converted to str
        vless_flow="",              # Valid vless flow if is set for user (str)
        trojan_password="",         # Trojan password (str)
        shadowsocks_password="",    # Shadowsocks password (str)
        shadowsocks_method="",      # Valid shadowsocks method supported by backend
        ), 
    inbounds=[]                     # List of outbound tag, List[str]
    )

Methods

Before use any method you need to call start method and connect to node unless you will face NodeAPIError for every method

await node.start(
    config=config,  # backend config as string 
    backend_type=0, # backend type , XRAY = 0
    users=[],       # list of users you want to add to this node, will be recheck in node with config
    timeout=20,
    )

Get User Stats

stats = await node.get_user_stats(
    email="noreply@donate.gozargah.pro",
    reset=True,
    timeout=10,
    )

Health

Return a Bridge.Health

health = await node.get_health()

Logs

Return a asyncio.Queue[str]

logs = await node.get_logs()

Metadata

Release files for gozargah-node-bridge 0.0.44

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gozargah-node-bridge 0.0.44
File Size Uploaded
gozargah_node_bridge-0.0.44.tar.gz 43.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for gozargah-node-bridge 0.0.44
File Interpreter ABI Platform
gozargah_node_bridge-0.0.44-py3-none-any.whl Python 3 none any Details

Total release size: 75.1 kB

Release files / gozargah_node_bridge-0.0.44.tar.gz

Download URL gozargah_node_bridge-0.0.44.tar.gz
Size 43.8 kB
Tags Source
SHA-256 checksum
How to use checksums
185c91a9b66b5ac8f50c05c20438c576a639497b5f761588a3e0e83f8c7d9d8f
BLAKE2b-256 checksum
How to use checksums
c5766f0f3931d712cc647994e87740c4d02cf7c2b68d75190a431c8d831a22c2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.3

Release files / gozargah_node_bridge-0.0.44-py3-none-any.whl

Download URL gozargah_node_bridge-0.0.44-py3-none-any.whl
Size 31.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6aa00dcaf0b193fc964c67719a7a5cf1bb756a5a29a7183023b55b9c88424331
BLAKE2b-256 checksum
How to use checksums
7929a27f43ea4b7d0991a553f7ea20ef640c516c9f243e503c095f663382220d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.3

Release history Release notifications | RSS feed

This release

0.0.44 This release

2 release files

0.0.43

2 release files

0.0.42

2 release files

0.0.41

2 release files

0.0.39

2 release files

0.0.38

2 release files

0.0.37

2 release files

0.0.36

2 release files

0.0.35

2 release files

0.0.34

2 release files

0.0.33

2 release files

0.0.32

2 release files

0.0.31

2 release files

0.0.29

2 release files

0.0.28

2 release files

0.0.27

2 release files

0.0.26

2 release files

0.0.25

2 release files

0.0.24

2 release files

0.0.23

2 release files

0.0.22

2 release files

0.0.21

2 release files

0.0.20

2 release files

0.0.19

2 release files

0.0.18

2 release files

0.0.17

2 release files

0.0.16

2 release files

0.0.15

2 release files

0.0.14

2 release files

0.0.9

2 release files

0.0.7

2 release files

0.0.6

2 release files

0.0.5

2 release files

0.0.4

2 release files

0.0.3

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page