Metadata-Version: 2.1
Name: vmngclient
Version: 0.2.0
Summary: Universal vManage API
Home-page: https://github.com/CiscoDevNet/vManage-client
Author: kagorski
Author-email: kagorski@cisco.com
Requires-Python: >=3.8,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Dist: Jinja2 (>=3.1.2,<4.0.0)
Requires-Dist: aiohttp (>=3.8.1,<4.0.0)
Requires-Dist: attrs (>=21.4.0,<22.0.0)
Requires-Dist: ciscoconfparse (>=1.6.40,<2.0.0)
Requires-Dist: parameterized (>=0.8.1,<0.9.0)
Requires-Dist: python-dateutil (>=2.8.2,<3.0.0)
Requires-Dist: requests (>=2.27.1,<3.0.0)
Requires-Dist: tenacity (>=8.1.0,<9.0.0)
Project-URL: Repository, https://github.com/CiscoDevNet/vManage-client
Description-Content-Type: text/markdown

# vManage-client
[![Python3.8](https://img.shields.io/static/v1?label=Python&logo=Python&color=3776AB&message=3.8)](https://www.python.org/)

vManage client is a package for creating simple and parallel automatic requests via official vManageAPI. It is intended to serve as a multiple session handler (provider, provider as a tenant, tenant). The library is not dependent on environment which is being run, you just need a connection to any vManage.

## Installation
```console
pip install vmngclient
```

## Hello world example

<details>
    <summary>Python (click to expand)</summary>

```Python
from vmngclient.session import create_vManageSession


base_url = "sandbox-sdwan-2.cisco.com/"
username = "devnetuser"
password = "RG!_Yw919_83"
session = create_vManageSession(url=base_url, username=username, password=password)


>>> "Logged as devnetuser. The session type is SessionType.TENANT"
>>> {'title': 'Cisco vManage', 'version': '20.4.2.1', 'applicationVersion': '20.4R-vbamboo-16-Dec-2021 19:07:17 PST', 'applicationServer': 'vmanage', 'copyright': 'Copyright (c) 2022, Cisco. All rights reserved.', 'time': '2022-12-01 13:45:44', 'timeZone': 'UTC', 'logo': '/dataservice/client/logo.png'}
```
</details>

### Note:
To remove `InsecureRequestWarning`, you can include in your scripts:
```Python
import urllib3
urllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning)
```

## User creation example

<details>
    <summary>Python (click to expand)</summary>

```Python
from vmngclient.api.administration import UserAlreadyExistsError, UserApi
from vmngclient.dataclasses import User
from vmngclient.session import create_vManageSession

session = create_vManageSession(url=..., username=..., password=...)
user_api = UserApi(session)

test_user = User(
    group=["basic"],
    description="Demo User",
    username="demouser",
    password="password",
    locale="en_US",
    resource_group="global"
)

try:
    user_api.create_user(test_user)
except UserAlreadyExistsError as error:
    print(f"User {username} already exists.")
```
</details>

## API usage examples

### AdminTechAPI

<details>
    <summary>Python (click to expand)</summary>

```Python
from vmngclient.session import create_vManageSession
from vmngclient.api.admin_tech_api import AdminTechAPI

session = create_vManageSession(url=..., username=..., password=...)
admintech = AdminTechAPI(session)
filename = admintech.generate("172.16.255.11")
admintech.download(filename)
admintech.delete(filename)
```

</details>


## Contributing, reporting issues, seeking support
Please contact authors direcly or via Issues Github page.

## **Enviroment setup**
1. Download Python3.8 or higher.
2. Download repository
    ```
    git clone https://github.com/CiscoDevNet/vManage-client.git
    ```
3. Install poetry v1.1.13
    ```
    pip install poetry==1.1.13
    ```
4. Install dependecies 
    ```
    poetry install
    ```
5. Activate `pre-commit`
    ```
    pre-commit install
    ```

## **Add new feature**
To add new feature create new branch and implement it. Before making a pull request make sure that `pre-commit` passes.
- **Building package for tests**\
    To make a `.whl` file run
    ```
    poetry build
    ```
    Then in `/vManage-client/dist/` directory there is a `.whl` file named `vmngclient-<version>-py3-none-any.whl`, which can be installed by running
    ```
    pip install vmngclient-<version>-py3-none-any.whl
    ```
