Metadata-Version: 2.1
Name: testlodge
Version: 0.0.39
Summary: Python client library for interacting with TestLodge.
Home-page: https://github.com/AceofSpades5757/testlodge
Author: Kyle L. Davis
Author-email: AceofSpades5757.github@gmail.com
License: MIT
Project-URL: Documentation, https://testlodge.readthedocs.io/en/latest/
Project-URL: Author, https://github.com/AceofSpades5757
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Operating System :: OS Independent
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE

[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white)](https://github.com/pre-commit/pre-commit)

[![pypi](https://img.shields.io/pypi/v/testlodge?style=plastic)](https://pypi.org/project/testlodge/)
[![Read the Docs](https://img.shields.io/readthedocs/testlodge)](https://testlodge.readthedocs.io/en/latest/)

![CI/CD](https://img.shields.io/github/checks-status/AceofSpades5757/testlodge/main?label=CI/CD)

[![Coverage](https://github.com/AceofSpades5757/testlodge/actions/workflows/tests.yml/badge.svg)](https://github.com/AceofSpades5757/testlodge/actions/workflows/github-actions.yml)

# Description

Python client library for interacting with TestLodge.

# Installation

`pip install testlodge`

# Usage

[Documentation]([https://img.shields.io/readthedocs/testlodge](https://testlodge.readthedocs.io/en/latest/))

```python
import os

from testlodge import Client


tl = Client(
    email='my.email@email.com',
    api_key=os.environ['TESTLODGE_API_KEY'],
    account_id=os.environ['TESTLODGE_ACCOUNT_ID'],
)
```

## Users

```python
from testlodge.typing import UserJSON
from testlodge.typing import UserListJSON


user_json: UserJSON = dict(
    id=123456,
    firstname='First',
    lastname='Last',
    email='user@email.com',
    created_at="2022-01-01T20:30:40.123456Z",
    updated_at="2022-05-16T01:08:41.493190Z",
)

# Get a list of users (Default: page 1)
user_list_json: UserListJSON = tl.list_user_json()
```

## Projects

```python
from testlodge.typing import ProjectJSON
from testlodge.typing import ProjectListJSON


# Get a list of projects (Default: page 1)
project_list_json: ProjectListJSON = tl.list_project_json()
# Get a project
project_list_json: ProjectJSON = tl.show_project_json(project_id=123)
```

## Custom Fields

```python
from testlodge.typing import CustomFieldListJSON


# Get a list of custom fields for a project
custom_field_list_json: CustomFieldListJSON = tl.list_custom_field_json(project_id=123)
```


