Metadata-Version: 2.4
Name: auviknetworks
Version: 1.0.0
Summary: Tosch Automatisering Auvik Networks libary
Author-email: Tosch Data Solutions <data@tosch.nl>, Jelle Blom <jb@tosch.nl>
License-File: LICENSE.txt
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: Python Software Foundation License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Requires-Dist: pandas>=2.2.2
Requires-Dist: requests>=2.32.3
Description-Content-Type: text/markdown

## AuvikNetworksConnection Class 
The AuvikNetworksConnection class provides an interface to interact with the Auvik Networks API, allowing users to authenticate and retrieve data related to tenants and devices. The class includes error handling and retry logic for API requests to ensure reliability. This README provides an overview of the class's functionality, methods, and usage.

# Class Summary
AuvikNetworksConnection
Purpose: To authenticate and interact with the Auvik Networks API.

# Command-list
get_tenants: Retrieves tenant information.
get_tenant_details: Retrieves detailed information for a specific tenant.
get_device_info: Retrieves device information for a specific tenant.
get_auvik_devices_info: Retrieves detailed device information, with optional additional details.

# Methods:
__init__(username: str, password: str): Initializes the connection and authenticates the user.
get_tenants(json_output: bool = False): Retrieves tenant information.
get_tenant_details(domain_prefix: str, json_output: bool = False): Retrieves detailed information for a specific tenant.
get_auvik_devices_info(tenant_id: str = None, include_detail: bool = False, json_output: bool = False): Retrieves detailed device information with optional detail fields.

Ensure you have the necessary Python packages installed:
import requests
import json
import pandas as pd
import time

# Initialization
To use the AuvikNetworksConnection class, you need to provide your Auvik username and password (API token):
from auvik_networks_connection import AuvikNetworksConnection

username = "your_username"
password = "your_password"

auvik_conn = AuvikNetworksConnection(username, password)

# Retrieve Tenants
You can retrieve tenant information using the get_tenants method:
tenants = auvik_conn.get_tenants()
print(tenants)
To retrieve the output in JSON format, set json_output to True:
tenants_json = auvik_conn.get_tenants(json_output=True)
print(tenants_json)

# Retrieve Tenant Details
To get detailed information for a specific tenant:

domain_prefix = "tenant_prefix"
tenant_details = auvik_conn.get_tenant_details(domain_prefix)
print(tenant_details)

# Retrieve Detailed Device Information
To get detailed device information, including specific fields:

detailed_device_info = auvik_conn.get_auvik_devices_info(tenant_id, include_detail=True)
print(detailed_device_info)
Error Handling
The APIErrorHandler class is used internally to handle API errors. If the API returns an error status code, an exception will be raised with a relevant message.

Retry Logic
The get method includes retry logic with three attempts in case of a request failure. The system waits 10 seconds before retrying.

# Notes
Ensure that your credentials are stored securely and not hard-coded in your scripts.
The get_access_token method handles the base64 encoding of credentials and authenticates with the Auvik API.
Use the json_output parameter to retrieve data in JSON format if required.