Metadata-Version: 2.1
Name: pyrena
Version: 1.4.2
Summary: Python wrapper for Arena QMS API.
Home-page: https://github.com/thecodeforge/pyrena
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: mistletoe
Requires-Dist: requests

# pyrena

API wrapper for interacting with Arena QMS.

Pyrena is not associated with or approved by Arena Solutions or PTC.

## Installation

`pip install pyrena`

## Docs

Documentation generated by Pyrena self-introspecting its own code. This goes into more detail than this readme.

```python
import pyrena
pyrena.docs()
```

## Usage

### Create client

```python
import pyrena

client = pyrena.Arena("username", "password")
```

Users on the government server should add the parameter `arenagov=True` during client creation.

Users on the Europe server should add the parameter `europe=True` during client creation. 

### Change users

```python
client.logout()
client.login("different_username", "different_password")
```

### Search

Define an object type and search parameters to get a list of results. Functions equivalently to top bar search on Arena website; however searching based on custom attributes must use the custom attribute GUID. See Arena help documentation on app.bom.com

```python
search_results = client.Listing(client.QualityProcess, number="NCMR-*")
```

### Retrieve specific object

Option 1 - get object by object GUID, if known

```python
my_change_order = client.Change("object_guid")
```

Option 2 - get object by its "user-friendly" ID (known as `number` in the API)

```python
my_capa = client.find(client.QualityProcess, number="CAPA-000001")
```
