ones-pyapi 0.1.0__tar.gz

ones_pyapi-0.1.0/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: ones-pyapi
+Version: 0.1.0
+Summary: Python SDK for ONES (Aviz Networks)
+Author-email: Kavyansh Pandey <kavyansh.pandey@aviznetworks.com>
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests
+
+ones_sdk/
+│
+├── ones/                     # main package
+│   ├── __init__.py
+│   │
+│   ├── client.py            # main entry point
+│   ├── transport.py         # HTTP layer
+│   ├── exceptions.py        # custom errors
+│   ├── constants.py         # endpoints, paths
+│   │
+│   ├── resources/           # API groups
+│   │   ├── __init__.py
+│   │   ├── base.py
+│   │   ├── user.py
+│   │   ├── health.py
+│   │   └── inventory.py
+│   │
+│   ├── utils/               # helpers
+│   │   ├── __init__.py
+│   │   └── parser.py        # json parsing helpers
+│   │
+│   └── models/              # (optional, later)
+│       ├── __init__.py
+│       └── user.py
+│
+├── tests/
+│   ├── test_user.py
+│   ├── test_health.py
+│   └── test_inventory.py
+│
+├── examples/
+│   └── basic_usage.py
+│
+├── requirements.txt
+├── setup.py / pyproject.toml
+└── README.md

ones_pyapi-0.1.0/README.md

@@ -0,0 +1,36 @@
+ones_sdk/
+│
+├── ones/                     # main package
+│   ├── __init__.py
+│   │
+│   ├── client.py            # main entry point
+│   ├── transport.py         # HTTP layer
+│   ├── exceptions.py        # custom errors
+│   ├── constants.py         # endpoints, paths
+│   │
+│   ├── resources/           # API groups
+│   │   ├── __init__.py
+│   │   ├── base.py
+│   │   ├── user.py
+│   │   ├── health.py
+│   │   └── inventory.py
+│   │
+│   ├── utils/               # helpers
+│   │   ├── __init__.py
+│   │   └── parser.py        # json parsing helpers
+│   │
+│   └── models/              # (optional, later)
+│       ├── __init__.py
+│       └── user.py
+│
+├── tests/
+│   ├── test_user.py
+│   ├── test_health.py
+│   └── test_inventory.py
+│
+├── examples/
+│   └── basic_usage.py
+│
+├── requirements.txt
+├── setup.py / pyproject.toml
+└── README.md

ones_pyapi-0.1.0/examples/examples_usage_bgp.py

@@ -0,0 +1,49 @@
+from ones.client import ONESClient
+
+client = ONESClient(
+    url="https://your-instance/",
+    username="your_username",
+    password="your_password"
+)
+
+client.connect()
+
+# 1. BGP List
+bgp_list = client.bgp.bgp_list()
+print("BGP List:", bgp_list)
+
+# 2. Neighbor List
+neighbors = client.bgp.neighbor_list(device_address="xx.xx.xx.xx.xx.xx", vrf="default")
+print("Neighbor List:", neighbors)
+
+# 3. Protocol Mega
+protocol_mega = client.bgp.protocol_mega(
+    from_date="2026-03-23 10:09:36",
+    to_date="2026-03-23 11:09:36",
+    window_size="1 hour",
+    device_address="xx.xx.xx.xx.xx.xx",
+    vrf="default"
+)
+print("Protocol Mega:", protocol_mega)      
+
+# 4. Protocol Neighbor Mega
+protocol_neighbor_mega = client.bgp.protocol_neighbor_mega(
+    from_date="2026-03-23 10:09:36",
+    to_date="2026-03-23 11:09:36",  
+    window_size="1 hour",
+    device_address="xx.xx.xx.xx.xx.xx",
+    vrf="default"
+)
+print("Protocol Neighbor Mega:", protocol_neighbor_mega)
+
+protocol_bgps = client.bgp.protocols_bgp(ip_address="x.x.x.x")
+print("Protocol Map:", protocol_bgps)
+
+vlan_mapping = client.bgp.vlan_mapping(device_address="xx.xx.xx.xx.xx.xx")
+print("VLAN Mapping:", vlan_mapping)
+
+
+
+
+
+

ones_pyapi-0.1.0/examples/examples_usage_control_plane.py

@@ -0,0 +1,27 @@
+from ones.client import ONESClient
+
+client = ONESClient(
+    url="https://your-instance/",
+    username="your_username",
+    password="your_password"
+)
+
+client.connect()
+
+
+# VLAN
+vlan_info = client.control_plane.vlan()
+print("VLAN Info:", vlan_info)  
+
+# MCLAG
+mclag_info = client.control_plane.mclag()
+print("MCLAG Info:", mclag_info)
+
+# LACP
+lacp_info = client.control_plane.lacp()
+print("LACP Info:", lacp_info)
+
+# VRRP
+vrrp_info = client.control_plane.vrrp()
+print("VRRP Info:", vrrp_info)
+

ones_pyapi-0.1.0/examples/examples_usage_device.py

@@ -0,0 +1,47 @@
+from ones.client import ONESClient
+client = ONESClient(
+    url="https://your-instance/",
+    username="your_username",
+    password="your_password"
+)
+
+client.connect()
+
+
+# Example usage of DeviceResource methods
+links = client.device.get_links()
+print("Links:", links)
+
+
+transceiver_mega = client.device.get_transceiver_mega(
+    from_date="2024-06-01T00:00:00Z",
+    to_date="2024-06-02T00:00:00Z",
+    window_size=10,
+    device_address="example_device_address",
+    active_tab="example_active_tab",
+    ifname="example_ifname"
+)
+
+print("Transceiver Mega:", transceiver_mega)
+
+transceiver_details = client.device.get_transceiver_details(
+    device_address="example_device_address",
+    name="example_name"
+)
+print("Transceiver Details:", transceiver_details)      
+
+device_list_telemetry_version_and_fm_version = client.device.get_device_list_telemetry_version_and_fm_version()
+print("Device List Telemetry Version and FM Version:", device_list_telemetry_version_and_fm_version)
+
+interfaces = client.device.get_interfaces()
+print("Interfaces:", interfaces)
+
+gpu_list = client.device.get_gpu_list()
+print("GPU List:", gpu_list)
+
+docker_containers = client.device.get_docker_containers()
+print("Docker Containers:", docker_containers)
+gpu_stats = client.device.get_gpu_stats()
+print("GPU Stats:", gpu_stats)
+image_management_status = client.device.get_image_management_status(ip_address="example_ip_address")
+print("Image Management Status:", image_management_status)

ones_pyapi-0.1.0/examples/examples_usage_fm.py

@@ -0,0 +1,26 @@
+
+from ones.client import ONESClient
+
+client = ONESClient(
+    url="https://your-instance/",
+    username="your_username",
+    password="your_password"
+)
+
+client.connect()
+
+
+
+# Testing FM Backup Config API
+check =client.fm.backupConfig({
+    "data": [
+        {
+            "ip": "xx.xx.xx.xx",
+            "label": "ss"
+        }
+    ]
+})
+
+print(check)
+
+

ones_pyapi-0.1.0/examples/examples_usage_health.py

@@ -0,0 +1,42 @@
+from ones.client import ONESClient
+
+client = ONESClient(
+    url="https://your-instance/",
+    username="your_username",
+    password="your_password"
+)
+
+client.connect()
+
+# Device List
+devices = client.health.device_list()
+print("Devices:", devices)
+
+# Device Info
+info = client.health.device_info(
+    from_date="2026-03-23 00:56:30",
+    to_date="2026-03-24 09:56:30",
+    window_size="1 hour",
+    device_address="xx.xx.xx.xx.xx.xx"
+)
+print("Device Info:", info)
+
+# Mega API
+mega = client.health.mega(
+    from_date="2026-03-23 12:05:44",
+    to_date="2026-03-24 12:05:44",
+    window_size="1 day",
+    device_address="xx.xx.xx.xx.xx.xx"
+)
+print("Mega:", mega)
+
+# Top CPU Consuming Services
+top_services = client.health.top_cpu_consuming_services(
+    device_address="xx.xx.xx.xx.xx.xx"
+)
+
+print("Top CPU Consuming Services:", top_services)
+
+# Fabric Wise Health
+fabric_health = client.health.fabric_wise_health()
+print("Fabric Wise Health:", fabric_health)

ones_pyapi-0.1.0/examples/examples_usage_inventory.py

@@ -0,0 +1,68 @@
+from ones.client import ONESClient
+
+client = ONESClient(
+    url="https://your-instance/",
+    username="your_username",
+    password="your_password"
+)
+
+client.connect()
+
+# Device Interfaces
+interfaces = client.inventory.device_interfaces(device_address="xx.xx.xx.xx.xx.xx")
+print("Device Interfaces:", interfaces) 
+
+# Device Peripherals
+peripherals = client.inventory.device_peripherals(device_address="xx.xx.xx.xx.xx.xx")
+print("Device Peripherals:", peripherals)
+
+# Device Info
+device_info = client.inventory.device_info(device_address="xx.xx.xx.xx.xx.xx")
+print("Device Info:", device_info)
+
+# Device Firmware
+firmware = client.inventory.device_firmware(device_address="xx.xx.xx.xx.xx.xx")
+print("Device Firmware:", firmware)
+
+# Link Info
+link_info = client.inventory.link_info(device_address="xx.xx.xx.xx.xx.xx")
+print("Link Info:", link_info)  
+
+# minizip test
+minizip = client.inventory.minizip_test()
+print("Minizip Test:", minizip)
+
+# Interface Flaps
+interface_flaps = client.inventory.interface_flaps(
+    start_time="2026-03-23 02:09:36",
+    end_time="2026-03-24 11:09:36",
+    limit=10
+)
+print("Interface Flaps:", interface_flaps)
+
+# Interface Mega
+interface_mega = client.inventory.interface_mega()
+print("Interface Mega:", interface_mega)
+
+# NIC Info
+nic_info = client.inventory.nic_info(device_address="xx.xx.xx.xx.xx.xx")
+print("NIC Info:", nic_info)        
+
+# Device Details
+device_details = client.inventory.device_details(device_address="xx.xx.xx.xx.xx.xx")
+print("Device Details:", device_details)
+
+# Inventory Details Orchestration
+inv_details_orchest = client.inventory.inv_details_orchest()
+print("Inventory Details Orchestration:", inv_details_orchest)
+
+
+# Device YAML Files
+device_yaml_files = client.inventory.device_yaml_files()
+print("Device YAML Files:", device_yaml_files)  
+
+# Mini Inventory
+mini_inventory = client.inventory.mini_inventory()
+print("Mini Inventory:", mini_inventory)
+
+

ones_pyapi-0.1.0/examples/examples_usage_misc.py

@@ -0,0 +1,29 @@
+from ones.client import ONESClient
+
+client = ONESClient(
+    url="https://your-instance/",
+    username="your_username",
+    password="your_password"
+)
+
+client.connect()
+
+
+# Add methofs for above calls
+is_fm_enabled = client.misc.is_fm_enabled()
+print("Is FM Enabled:", is_fm_enabled)
+
+world_map_data = client.misc.world_map_data()
+print("World Map Data:", world_map_data)
+
+is_ai_assistant_enabled = client.misc.is_ai_assistant_enabled()
+print("Is AI Assistant Enabled:", is_ai_assistant_enabled)
+
+illustrator_yaml = client.misc.get_illustrator_yaml()
+print("Illustrator YAML:", illustrator_yaml)
+
+region_list = client.misc.region_list()
+print("Region List:", region_list)
+
+telemetry_preferences = client.misc.telemetry_preferences()
+print("Telemetry Preferences:", telemetry_preferences)

ones_pyapi-0.1.0/examples/examples_usage_traffic.py

@@ -0,0 +1,59 @@
+
+from ones.client import ONESClient
+
+client = ONESClient(
+    url="https://your-instance/",
+    username="your_username",
+    password="your_password"
+)
+
+client.connect()
+
+
+
+# 1. is_interf_pfc_enabled
+resp1 = client.traffic.is_interf_pfc_enabled(device_address="xx.xx.xx.xx.xx.xx", ifname="Ethernet1")
+print("is_interf_pfc_enabled:", resp1)
+
+# 2. traffic_list
+resp2 = client.traffic.traffic_list(device_address="xx.xx.xx.xx.xx.xx")
+print("traffic_list:", resp2)
+
+# 3. get_interface_details
+resp3 = client.traffic.get_interface_details(
+    device_address="xx.xx.xx.xx.xx.xx",
+    hostname="switch1",
+    ipaddress="192.168.1.1",
+    layer="L2",
+    time_bucket="5m",
+    window_size=10,
+    license_="standard"
+)
+print("get_interface_details:", resp3)
+
+# 4. interface_details
+resp4 = client.traffic.interface_details(
+    from_date="2024-06-01T00:00:00Z",
+    to_date="2024-06-02T00:00:00Z",
+    window_size=10,
+    device_address="xx.xx.xx.xx.xx.xx",
+    active_tab="tab1",
+    ifname="Ethernet1"
+)
+print("interface_details:", resp4)
+
+# 5. traffic_mega
+resp5 = client.traffic.traffic_mega(
+    from_date="2024-06-01T00:00:00Z",
+    to_date="2024-06-02T00:00:00Z",
+    window_size=10,
+    device_address="xx.xx.xx.xx.xx.xx",
+    active_tab="tab1",
+    ifname="Ethernet1"
+)
+print("traffic_mega:", resp5)
+
+# 6. priority_mapping
+resp6 = client.traffic.priority_mapping(device_address="xx.xx.xx.xx.xx.xx", ifname="Ethernet1")
+print("priority_mapping:", resp6)
+

ones_pyapi-0.1.0/examples/test_example.py

@@ -0,0 +1,13 @@
+# examples/basic_usage.py
+
+from ones.client import ONESClient
+
+client = ONESClient(
+    url="https://your-instance/",
+    username="your_username",
+    password="your_password"
+)
+
+client.connect()
+
+print(client.user.list())

ones_pyapi-0.1.0/ones/__init__.py

@@ -0,0 +1,3 @@
+from .client import ONESClient
+
+__all__ = ["ONESClient"]

ones_pyapi-0.1.0/ones/client.py

@@ -0,0 +1,75 @@
+# ones/client.py
+
+import requests
+from .transport import Transport
+from .resources.user import UserResource
+from .resources.health import HealthResource
+from .resources.inventory import InventoryResource
+from .resources.traffic import TrafficResource
+from .resources.bgp import BGPResource
+from .resources.control_plane import ControlPlaneResource  
+from .resources.misc import MiscResource
+from .resources.device import DeviceResource
+from .resources.fm import FMResource
+
+class ONESClient:
+    def __init__(self, url, username=None, password=None):
+        self.url = url
+        self.username = username
+        self.password = password
+
+        self.transport = Transport(base_url=url)
+
+        # attach resources
+        self.user = UserResource(self.transport)
+
+        # attach health
+        self.health = HealthResource(self.transport)
+
+        # attch inventory
+        self.inventory = InventoryResource(self.transport)
+
+        # attach traffic
+        self.traffic = TrafficResource(self.transport)
+
+        # attach BGP
+        self.bgp = BGPResource(self.transport)
+
+        # attch control plane
+        self.control_plane = ControlPlaneResource(self.transport)
+
+        # attach misc
+        self.misc = MiscResource(self.transport)
+
+        #attach device
+        self.device = DeviceResource(self.transport)
+
+        # Attach FM 
+        self.fm = FMResource(self.transport)
+
+    def connect(self):
+        import requests
+
+        resp = requests.post(
+            f"{self.url}/api/user/login",
+            json={
+                "username": self.username,
+                "password": self.password,
+                "extendedExpiry": False
+            },
+            verify=False
+        )
+
+        print("STATUS:", resp.status_code)
+        print("RAW RESPONSE:", resp.text)   # 👈 VERY IMPORTANT
+
+        if resp.status_code != 200:
+            raise Exception(resp.text)
+
+        try:
+            data = resp.json()
+        except Exception:
+            raise Exception(f"Invalid JSON response: {resp.text}")
+
+        token = data["data"]["token"]
+        self.transport.set_token(token)

ones_pyapi-0.1.0/ones/exceptions.py

@@ -0,0 +1,2 @@
+class OnesClientException(Exception):
+    pass

ones_pyapi-0.1.0/ones/resources/base.py

@@ -0,0 +1,24 @@
+# ones/resources/base.py
+
+import json
+
+
+class BaseResource:
+    def __init__(self, transport):
+        self.transport = transport
+
+    def _get(self, path, filters=None):
+        params = None
+        if filters:
+            params = {"filter": json.dumps(filters)}
+        return self.transport.request("GET", path, params=params)
+
+    def _post(self, path, payload=None):
+        return self.transport.request("POST", path, json=payload)
+
+    def _put(self, path, payload=None):
+        return self.transport.request("PUT", path, json=payload)
+
+    def _delete(self, path):
+        return self.transport.request("DELETE", path)
+    

ones_pyapi-0.1.0/ones/resources/bgp.py

@@ -0,0 +1,80 @@
+from .base import BaseResource
+
+class BGPResource(BaseResource):
+    BASE = "/api/bgps"
+
+    # Handlers
+    def bgp_list(self):
+        return self._get(f"{self.BASE}/list")
+
+    def neighbor_list(self, device_address, vrf):
+        filters = {
+            "deviceAddress": device_address,
+            "vrf": vrf
+        }
+
+        return self._get(f"{self.BASE}/neighborList", filters=filters)
+    
+    def protocol_mega(self, from_date, to_date, window_size, device_address, vrf):
+        filters = {
+            "fromDate": from_date,
+            "toDate": to_date,
+            "windowSize": window_size,
+            "deviceAddress": device_address,
+            "vrf": vrf
+        }
+
+        return self._get(f"{self.BASE}/protocolMega", filters=filters)
+    
+    def protocol_neighbor_mega(self, from_date, to_date, window_size, device_address, vrf):
+        filters = {
+            "fromDate": from_date,
+            "toDate": to_date,
+            "windowSize": window_size,
+            "deviceAddress": device_address,
+            "vrf": vrf
+        }
+
+        return self._get(f"{self.BASE}/protocolNeighborMega", filters=filters)
+    
+
+    def protocols_bgp(self, ip_address):
+        filters = {
+            "ipAddress": ip_address
+        }
+
+        return self._get(f"{self.BASE}/Protocols/bgp", filters=filters)
+    
+
+    def vlan_mapping(self, device_address):
+        filters = {
+            "deviceAddress": device_address
+        }
+
+        return self._get(f"{self.BASE}/vlanMapping", filters=filters)
+
+    def mclag_grid(self, device_address, domain_id, window_size):
+        filters = {
+            "deviceAddress": device_address,
+            "domainId": domain_id,
+            "windowSize": window_size
+        }
+
+        return self._get(f"{self.BASE}/mclag-grid", filters=filters)
+    
+    def lacp_grid(self, device_address, port_channel, window_size):
+        filters = {
+            "deviceAddress": device_address,
+            "portChannel": port_channel,
+            "windowSize": window_size
+        }
+
+        return self._get(f"{self.BASE}/lacp-grid", filters=filters)
+
+    def vtep_health_grid(self, device_address, remote_vtep_ip, window_size):
+        filters = {
+            "deviceAddress": device_address,
+            "windowSize": window_size
+        }
+
+        return self._get(f"{self.BASE}/vtep-health-grid", filters=filters)

ones_pyapi-0.1.0/ones/resources/control_plane.py

@@ -0,0 +1,19 @@
+from .base import BaseResource
+
+class ControlPlaneResource(BaseResource):
+    BASE = "/api/Control-plane" 
+
+    def vxlan(self):
+        return self._get(f"{self.BASE}/vxlan")
+
+    def mclag(self):
+        return self._get(f"{self.BASE}/mclag")
+    
+    def lacp(self):
+        return self._get(f"{self.BASE}/lacp")
+    
+    def vrrp(self):
+        return self._get(f"{self.BASE}/vrrp")
+    
+    def vlan(self):
+        return self._get(f"{self.BASE}/vlan")

ones_pyapi-0.1.0/ones/resources/device.py

@@ -0,0 +1,46 @@
+from .base import BaseResource
+
+class DeviceResource(BaseResource):
+    BASE = "/api/devices"
+
+    def get_links(self):
+        return self._get(f"{self.BASE}/links")
+
+    def get_transceiver_info(self, filters):
+        return self._get(f"{self.BASE}/transceiverInfo", filters=filters)
+
+    def get_transceiver_mega(self, from_date, to_date, window_size, device_address, active_tab, ifname):
+        filters = {
+            "fromDate": from_date,
+            "toDate": to_date,
+            "windowSize": window_size,
+            "deviceAddress": device_address,
+            "activeTab": active_tab,
+            "ifname": ifname
+        }
+        return self._get(f"{self.BASE}/transceiverMega", filters=filters)
+
+    def get_transceiver_details(self, device_address, name):
+        filters = {
+            "deviceAddress": device_address,
+            "name": name
+        }
+        return self._get(f"/api/Device/transceiverDetails", filters=filters)
+
+    def get_device_list_telemetry_version_and_fm_version(self):
+        return self._get(f"/api/Device/deviceListTelemetryVersionAndFMVersion")
+
+    def get_interfaces(self):
+        return self._get(f"/api/Device/interfaces")
+
+    def get_gpu_list(self):
+        return self._get(f"/api/Device/gpulist")
+
+    def get_docker_containers(self):
+        return self._get(f"/api/Device/docker-containers")
+
+    def get_gpu_stats(self):
+        return self._get(f"/api/Device/gpu-stats")
+
+    def get_image_management_status(self, ip_address):
+        return self._get(f"/api/device/imageManagementStatus", filters={"ipAddress": ip_address})

ones_pyapi-0.1.0/ones/resources/fm.py

@@ -0,0 +1,137 @@
+from .base import BaseResource
+
+
+class FMResource(BaseResource):
+    BASE = "/api/config"
+
+    # =====================================
+    # FABRIC APIs
+    # =====================================
+    def listFabric(self):
+        return self._get(f"{self.BASE}/listFabric")
+
+    def getFabric(self, fabricId):
+        return self._get(f"{self.BASE}/getFabric", filters={"fabricId": fabricId})
+
+    def createFabric(self, payload):
+        return self._post(f"{self.BASE}/createFabric", payload)
+
+    def deleteFabric(self, payload):
+        return self._post(f"{self.BASE}/deleteFabric", payload)
+
+    def updateFabric(self, payload):
+        return self._patch(f"{self.BASE}/updateFabric", payload)
+
+    # =====================================
+    # INTENT APIs (DAY-1)
+    # =====================================
+    def uploadIntent(self, payload):
+        return self._post(f"{self.BASE}/uploadIntent", payload)
+
+    def validateIntent(self, payload):
+        return self._post(f"{self.BASE}/validateIntent", payload)
+
+    def getIntentValidation(self, fabricId):
+        return self._get(
+            f"{self.BASE}/getIntentValidation",
+            filters={"fabricId": fabricId}
+        )
+
+    def applyIntent(self, payload):
+        return self._post(f"{self.BASE}/applyIntent", payload)
+
+    def getIntentStatus(self, fabricId):
+        return self._get(
+            f"{self.BASE}/getIntentStatus",
+            filters={"fabricId": fabricId}
+        )
+
+    # =====================================
+    # CONFIG APIs (DAY-2)
+    # =====================================
+    def backupConfig(self, payload):
+        return self._post(f"{self.BASE}/backupConfig", payload)
+
+    def restoreConfig(self, payload):
+        return self._post(f"{self.BASE}/restoreConfig", payload)
+
+    def replaceConfig(self, payload):
+        return self._post(f"{self.BASE}/replaceConfig", payload)
+
+    def diffConfig(self, fabricId):
+        return self._get(
+            f"{self.BASE}/diffConfig",
+            filters={"fabricId": fabricId}
+        )
+
+    def commitConfig(self, payload):
+        return self._post(f"{self.BASE}/commitConfig", payload)
+
+    def getConfigStatus(self, fabricId):
+        return self._get(
+            f"{self.BASE}/getConfigStatus",
+            filters={"fabricId": fabricId}
+        )
+
+    # =====================================
+    # DEVICE APIs
+    # =====================================
+    def listDevice(self, fabricId):
+        return self._get(
+            f"{self.BASE}/listDevice",
+            filters={"fabricId": fabricId}
+        )
+
+    def getDevice(self, deviceId):
+        return self._get(
+            f"{self.BASE}/getDevice",
+            filters={"deviceId": deviceId}
+        )
+
+    def rebootDevice(self, payload):
+        return self._post(f"{self.BASE}/rebootDevice", payload)
+
+    def upgradeDevice(self, payload):
+        return self._post(f"{self.BASE}/upgradeDevice", payload)
+
+    def replaceDevice(self, payload):
+        return self._post(f"{self.BASE}/replaceDevice", payload)
+
+    # =====================================
+    # TENANT APIs
+    # =====================================
+    def addTenant(self, payload):
+        return self._post(f"{self.BASE}/addTenant", payload)
+
+    def deleteTenant(self, payload):
+        return self._post(f"{self.BASE}/deleteTenant", payload)
+
+    def listTenant(self, fabricId):
+        return self._get(
+            f"{self.BASE}/listTenant",
+            filters={"fabricId": fabricId}
+        )
+
+    # =====================================
+    # JOB APIs
+    # =====================================
+    def listJobs(self):
+        return self._get(f"{self.BASE}/listJobs")
+
+    def getJobStatus(self, jobId):
+        return self._get(
+            f"{self.BASE}/getJobStatus",
+            filters={"jobId": jobId}
+        )
+
+    # =====================================
+    # GENERIC FALLBACK (KEEP THIS)
+    # =====================================
+    def customGET(self, path, filters=None):
+        return self._get(path, filters=filters)
+
+    def customPOST(self, path, payload=None):
+        return self._post(path, payload)
+
+    def customPATCH(self, path, payload=None):
+        return self.transport.request("PATCH", path, json=payload)

ones_pyapi-0.1.0/ones/resources/health.py

@@ -0,0 +1,63 @@
+# ones/resources/health.py
+
+from .base import BaseResource
+
+
+class HealthResource(BaseResource):
+    BASE = "/api/health"
+
+    def device_list(self):
+        return self._get(f"{self.BASE}/DeviceList")
+
+    def device_info(
+        self,
+        from_date,
+        to_date,
+        window_size,
+        device_address,
+        fan=None,
+        psu=None,
+        active_tab="system",
+    ):
+        filters = {
+            "fromDate": from_date,
+            "toDate": to_date,
+            "windowSize": window_size,
+            "deviceAddress": device_address,
+            "fan": fan,
+            "psu": psu,
+            "activeTab": active_tab,
+        }
+
+        return self._get(f"{self.BASE}/deviceInfo", filters=filters)
+    
+    def mega(
+        self,
+        from_date,
+        to_date,
+        window_size,
+        device_address,
+    ):
+        filters = {
+            "fromDate": from_date,
+            "toDate": to_date,
+            "windowSize": window_size,
+            "deviceAddress": device_address,
+        }
+
+        return self._get(f"{self.BASE}/mega", filters=filters)
+    
+    # GET	/health/topCpuConsumingServices	"68:21:5F:A6:61:72"
+
+    def top_cpu_consuming_services(self, device_address):
+        filters = {
+            "deviceAddress": device_address
+        }
+
+        return self._get(f"{self.BASE}/topCpuConsumingServices", filters=filters)   
+    
+    # GET	/health/fabricWiseHealth	NULL
+
+    def fabric_wise_health(self):
+        return self._get(f"{self.BASE}/fabricWiseHealth")
+    

ones_pyapi-0.1.0/ones/resources/inventory.py

@@ -0,0 +1,145 @@
+from .base import BaseResource
+
+class InventoryResource(BaseResource):
+    BASE = "/api/inventory"
+
+    def fm_agent_version_list(self):
+        return self._get(f"{self.BASE}/FMAgentVersionList")
+    
+    def get_inventory_roles(self):
+        return self._get(f"{self.BASE}/Roles")
+    
+    def get_switch_skus(self):
+        return self._get(f"{self.BASE}/SwitchSKUs")
+    
+    def get_devices(self):
+        return self._get(f"{self.BASE}/Devices")
+    
+    def get_action_btn(self):
+        return self._get(f"{self.BASE}/ActionBtn")
+    
+    def get_device_ip_trans(self):
+        return self._get(f"{self.BASE}/DeviceIpTrans")
+    
+    # GET	/inventory/Devices/streaming-status-history	{  "deviceAddress" : "68:21:5F:A6:61:72",  "windowSize" : "4 hour" }
+    def streaming_status_history(self, device_address, window_size):
+        filters = {
+            "deviceAddress": device_address,
+            "windowSize": window_size
+        }
+
+        return self._get(f"{self.BASE}/Devices/streaming-status-history", filters=filters)
+    
+
+# GET	/inventory/Devices/streaming-status	{  "deviceAddress" : "68:21:5F:A6:61:72",  "windowSize" : "4 hour" }
+    def streaming_status(self, device_address, window_size):
+        filters = {
+            "deviceAddress": device_address,
+            "windowSize": window_size
+        }
+
+        return self._get(f"{self.BASE}/Devices/streaming-status", filters=filters)  
+    
+
+# GET	/inventory/Devices/qosOnly	NULL
+    def qos_only(self):
+        return self._get(f"{self.BASE}/Devices/qosOnly")
+
+
+
+# GET	/inventory/Devices/count	NULL
+    def device_count(self):
+        return self._get(f"{self.BASE}/Devices/count")
+    
+
+# GET	/inventory/Devices/interfaces	{  "deviceAddress" : "68:21:5F:A6:4A:72" }
+    def device_interfaces(self, device_address):
+        filters = {
+            "deviceAddress": device_address
+        }
+
+        return self._get(f"{self.BASE}/Devices/interfaces", filters=filters)
+    
+
+# GET	/inventory/Devices/peripherals	{  "deviceAddress" : "68:21:5F:A6:4A:72" }
+    def device_peripherals(self, device_address):
+        filters = {
+            "deviceAddress": device_address
+        }
+
+        return self._get(f"{self.BASE}/Devices/peripherals", filters=filters)
+    
+
+# GET	/inventory/deviceInfo	{  "deviceAddress" : "68:21:5F:A6:4A:72" }
+    def device_info(self, device_address):
+        filters = {
+            "deviceAddress": device_address
+        }
+
+        return self._get(f"{self.BASE}/deviceInfo", filters=filters)
+    
+
+# GET	/inventory/Devices/firmware	{  "deviceAddress" : "68:21:5F:A6:4A:72" }
+    def device_firmware(self, device_address):
+        filters = {
+            "deviceAddress": device_address
+        }
+
+        return self._get(f"{self.BASE}/Devices/firmware", filters=filters)
+    
+
+# GET	/inventory/linkInfo	{  "deviceAddress" : "68:21:5F:A6:4A:72" }
+    def link_info(self, device_address):
+        filters = {
+            "deviceAddress": device_address
+        }
+
+        return self._get(f"{self.BASE}/linkInfo", filters=filters)
+    
+
+# GET	/inventory/minizip-test	NULL
+    def minizip_test(self):
+        return self._get(f"{self.BASE}/minizip-test")
+    
+
+# GET	/inventory/interfaceFlaps	{  "startTime" : "2026-03-23 02:09:36",  "endTime" : "2026-03-24 11:09:36",  "limit" : 10 }
+    def interface_flaps(self, start_time, end_time, limit):
+        filters = {
+            "startTime": start_time,
+            "endTime": end_time,
+            "limit": limit
+        }
+
+        return self._get(f"{self.BASE}/interfaceFlaps", filters=filters)
+    
+# GET	/inventory/interfaceMega	NULL
+    def interface_mega(self):
+        return self._get(f"{self.BASE}/interfaceMega")
+    
+# GET	/inventory/nic-info	{  "deviceAddress" : "68:21:5F:A6:61:72" }
+    def nic_info(self, device_address):
+        filters = {
+            "deviceAddress": device_address
+        }
+
+        return self._get(f"{self.BASE}/nic-info", filters=filters)
+    
+# GET	/inventory/device-details	{  "deviceAddress" : "68:21:5F:A6:61:72" }
+    def device_details(self, device_address):
+        filters = {
+            "deviceAddress": device_address
+        }
+
+        return self._get(f"{self.BASE}/device-details", filters=filters)
+    
+# GET	/inventory/inv-details-orchest	NULL
+    def inv_details_orchest(self):
+        return self._get(f"{self.BASE}/inv-details-orchest")
+    
+# GET	/inventory/device-yaml-files	NULL
+    def device_yaml_files(self):
+        return self._get(f"{self.BASE}/device-yaml-files")
+    
+# GET	/inventory/mini-inventory	NULL
+    def mini_inventory(self):
+        return self._get(f"{self.BASE}/mini-inventory")

ones_pyapi-0.1.0/ones/resources/misc.py

@@ -0,0 +1,22 @@
+from .base import BaseResource
+
+class MiscResource(BaseResource):
+    BASE = "/api/misc"
+
+    def is_fm_enabled(self):
+        return self._get(f"{self.BASE}/isFmEnabled")
+
+    def world_map_data(self):
+        return self._get(f"{self.BASE}/world-map-data")
+
+    def is_ai_assistant_enabled(self):
+        return self._get(f"{self.BASE}/is-ai-assistant-enabled")
+
+    def get_illustrator_yaml(self):
+        return self._get(f"{self.BASE}/get-illustrator-yaml")
+
+    def region_list(self):
+        return self._get(f"{self.BASE}/region-list")
+
+    def telemetry_preferences(self):
+        return self._get(f"{self.BASE}/telemetry-preferences")

ones_pyapi-0.1.0/ones/resources/traffic.py

@@ -0,0 +1,58 @@
+from .base import BaseResource
+
+class TrafficResource(BaseResource):
+    BASE = "/api/traffic"
+
+    def is_interf_pfc_enabled(self, device_address, ifname):
+        filters = {
+            "deviceAddress": device_address,
+            "ifname": ifname
+        }
+        return self._get(f"{self.BASE}/is-interf-pfc-enabled", filters=filters)
+
+    def traffic_list(self, device_address="all"):
+        filters = {
+            "deviceAddress": device_address
+        }
+        return self._get(f"{self.BASE}/trafficList", filters=filters)
+
+    def get_interface_details(self, device_address, hostname, ipaddress, layer, time_bucket, window_size, license_):
+        filters = {
+            "deviceAddress": device_address,
+            "hostname": hostname,
+            "ipaddress": ipaddress,
+            "layer": layer,
+            "timeBucket": time_bucket,
+            "windowSize": window_size,
+            "license": license_
+        }
+        return self._get(f"{self.BASE}/getInterfaceDetails", filters=filters)
+
+    def interface_details(self, from_date, to_date, window_size, device_address, active_tab, ifname):
+        filters = {
+            "fromDate": from_date,
+            "toDate": to_date,
+            "windowSize": window_size,
+            "deviceAddress": device_address,
+            "activeTab": active_tab,
+            "ifname": ifname
+        }
+        return self._get(f"{self.BASE}/interfaceDetails", filters=filters)
+
+    def traffic_mega(self, from_date, to_date, window_size, device_address, active_tab, ifname):
+        filters = {
+            "fromDate": from_date,
+            "toDate": to_date,
+            "windowSize": window_size,
+            "deviceAddress": device_address,
+            "activeTab": active_tab,
+            "ifname": ifname
+        }
+        return self._get(f"{self.BASE}/trafficMega", filters=filters)
+
+    def priority_mapping(self, device_address, ifname):
+        filters = {
+            "deviceAddress": device_address,
+            "ifname": ifname
+        }
+        return self._get(f"{self.BASE}/priorityMapping", filters=filters)

ones_pyapi-0.1.0/ones/resources/user.py

@@ -0,0 +1,16 @@
+# ones/resources/user.py
+
+from .base import BaseResource
+
+
+class UserResource(BaseResource):
+    BASE = "/api/user"
+
+    def list(self, filters=None):
+        return self._get(self.BASE, filters)
+
+    def roles(self):
+        return self._get(f"{self.BASE}/role")
+
+    def preferences(self):
+        return self._get(f"{self.BASE}/preferences")

ones_pyapi-0.1.0/ones/transport.py

@@ -0,0 +1,53 @@
+# ones/transport.py
+
+import requests
+import logging
+from .exceptions import OnesClientException
+
+
+class Transport:
+    def __init__(self, base_url, token=None, timeout=10, verify=False):
+        self.base_url = base_url.rstrip("/")
+        self.token = token
+        self.timeout = timeout
+        self.verify = verify
+
+        self.session = requests.Session()
+
+    def set_token(self, token):
+        self.token = token
+
+    def request(self, method, path, params=None, json=None):
+        url = f"{self.base_url}{path}"
+
+        print(f"REQUEST: {method} {url}")
+
+        headers = {"Content-Type": "application/json"}
+
+        if self.token:
+            headers["Authorization"] = self.token   # keep as-is (your backend expects this)
+
+        try:
+            resp = self.session.request(
+                method=method,
+                url=url,
+                headers=headers,
+                params=params,
+                json=json,
+                timeout=self.timeout,
+                verify=self.verify,
+            )
+
+            if resp.status_code not in (200, 201):
+                logging.error(f"Request failed: {method} {url} - Status: {resp.status_code} - Response: {resp.text}")
+                return None
+
+            try:
+                return resp.json()
+            except Exception:
+                logging.error(f"No JSON data returned: {resp.text}")
+                return None   # or {} if you prefer
+
+        except Exception as e:
+            logging.error(e)
+            raise OnesClientException(str(e))

ones_pyapi-0.1.0/ones_pyapi.egg-info/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: ones-pyapi
+Version: 0.1.0
+Summary: Python SDK for ONES (Aviz Networks)
+Author-email: Kavyansh Pandey <kavyansh.pandey@aviznetworks.com>
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests
+
+ones_sdk/
+│
+├── ones/                     # main package
+│   ├── __init__.py
+│   │
+│   ├── client.py            # main entry point
+│   ├── transport.py         # HTTP layer
+│   ├── exceptions.py        # custom errors
+│   ├── constants.py         # endpoints, paths
+│   │
+│   ├── resources/           # API groups
+│   │   ├── __init__.py
+│   │   ├── base.py
+│   │   ├── user.py
+│   │   ├── health.py
+│   │   └── inventory.py
+│   │
+│   ├── utils/               # helpers
+│   │   ├── __init__.py
+│   │   └── parser.py        # json parsing helpers
+│   │
+│   └── models/              # (optional, later)
+│       ├── __init__.py
+│       └── user.py
+│
+├── tests/
+│   ├── test_user.py
+│   ├── test_health.py
+│   └── test_inventory.py
+│
+├── examples/
+│   └── basic_usage.py
+│
+├── requirements.txt
+├── setup.py / pyproject.toml
+└── README.md

ones_pyapi-0.1.0/ones_pyapi.egg-info/SOURCES.txt

@@ -0,0 +1,31 @@
+README.md
+pyproject.toml
+examples/examples_usage_bgp.py
+examples/examples_usage_control_plane.py
+examples/examples_usage_device.py
+examples/examples_usage_fm.py
+examples/examples_usage_health.py
+examples/examples_usage_inventory.py
+examples/examples_usage_misc.py
+examples/examples_usage_traffic.py
+examples/test_example.py
+ones/__init__.py
+ones/client.py
+ones/exceptions.py
+ones/transport.py
+ones/resources/__init__.py
+ones/resources/base.py
+ones/resources/bgp.py
+ones/resources/control_plane.py
+ones/resources/device.py
+ones/resources/fm.py
+ones/resources/health.py
+ones/resources/inventory.py
+ones/resources/misc.py
+ones/resources/traffic.py
+ones/resources/user.py
+ones_pyapi.egg-info/PKG-INFO
+ones_pyapi.egg-info/SOURCES.txt
+ones_pyapi.egg-info/dependency_links.txt
+ones_pyapi.egg-info/requires.txt
+ones_pyapi.egg-info/top_level.txt

ones_pyapi-0.1.0/ones_pyapi.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

ones_pyapi-0.1.0/ones_pyapi.egg-info/requires.txt

@@ -0,0 +1 @@
+requests

ones_pyapi-0.1.0/ones_pyapi.egg-info/top_level.txt

@@ -0,0 +1,5 @@
+dist
+examples
+ones
+tests
+venv

ones_pyapi-0.1.0/pyproject.toml

@@ -0,0 +1,20 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ones-pyapi"
+version = "0.1.0"
+description = "Python SDK for ONES (Aviz Networks)"
+authors = [
+    { name="Kavyansh Pandey", email="kavyansh.pandey@aviznetworks.com" }
+]
+readme = "README.md"
+requires-python = ">=3.8"
+
+dependencies = [
+    "requests"
+]
+
+[tool.setuptools.packages.find]
+where = ["."]

ones_pyapi-0.1.0/setup.cfg

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