Metadata-Version: 2.1
Name: ado_wrapper
Version: 1.47.0
Summary: A high level wrapper around the AzureDevops API including OOP principals and state management
License: Proprietary
Author: Ben Skerritt
Requires-Python: >=3.10,<4.0
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: pyyaml (==6.0.1)
Requires-Dist: requests (==2.31.0)
Description-Content-Type: text/markdown

# Ado Wrapper

This is a Python Package which works as an interface to the Azure DevOps API

It is essentially a wrapper for the (horrible to work with) ADO API, and supports OOP principals.

Any resource can be fetched by calling the `<resource>.get_by_id()` function.

It also includes a solution for managing resources created by this script, which is extremely useful for testing the creation of random resources.
To delete all resources created by this, run the main module with the "--delete-everything" flag.

If you're reading this readme not from the code, here's a link to the [github repo](https://github.com/UP929312/ado-wrapper)


## Setup

It's recommended you create your own ADO organisation and project for testing/development, this is easy and means that  
you won't delete anything or cause problems, but may mean you're missing features such as certain teams or repos.

To test/add to this locally, you'll need to create a few files:  

For tests, add tests/test_data.txt, which contains:
```
ADO Organisation name  
ADO Project name (e.g. MyProject)  
ADO Secondary project name (e.g. can be empty for your testing, so just an empty line unless you're testing the client)  
Email: e.g. first.last@company.com  
Pat token (with good perms), https://dev.azure.com/<ORG>/_usersSettings/tokens  
Existing User ID, print(AdoUser.get_by_email(ado_client, "first.last@company.com").origin_id)  
Existing user descriptor, print(AdoUser.get_by_email(ado_client, "first.last@company.com").descriptor_id)  
```
For development, I recommend adding a script.py with this boiler plate:  

```py
with open("credentials.txt", "r") as file:
    email, ado_access_token, ado_org_name, ado_project = file.read().split("\n")

from ado_wrapper import AdoClient, Secret
from ado_wrapper.resources import *
from ado_wrapper.errors import *
ado_client = AdoClient(email, ado_access_token, ado_org_name, ado_project)
```
And then fill credentials.txt with email, PAT, org, project on different lines.

## Commands Used To Ensure Quality

pylint .  
mypy . --strict  
flake8 --ignore=E501,E126,E121,W503,W504,PBP --exclude=script.py  
bandit -c pyproject.toml -r .  
ruff check  
black . --line-length 140  
python3.11 -m pytest tests/ -vvvv -s  

