Metadata-Version: 2.1
Name: nacwrap
Version: 0.1.0
Summary: Python package that acts as a wrapper for the Nintex Automation Cloud system.
Home-page: https://github.com/pepsimidamerica/nacwrap
Author: Jordan Maynor
Author-email: jmaynor@pepsimidamerica.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: The Unlicense (Unlicense)
Classifier: Operating System :: OS Independent
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests

# Overview

nacwrap is a python package for interacting with the Nintex Automation Cloud system. Creating workflow instances, delegating tasks, etc. Essentially just a wrapper for the NAC API.

## Installation

Haven't yet bothered to publish as a python package, intent is to simply add nacwrap as a git submodule in any projects where it's needed.

## Usage

Several environment variables are required for nacwrap to function.

| Required? | Env Variable | Description |
| --------- | ------------ | ----------- |
| Yes | NINTEX_CLIENT_ID | Client ID for connecting to Nintex API. Created in Apps and Tokens page in NAC. |
| Yes | NINTEX_CLIENT_SECRET | Client secret for connecting to Nintex API. Created in Apps and Tokens page in NAC. |
| Yes | NINTEX_GRANT_TYPE | Value should be 'client_credentials'. |
| Yes | NINTEX_BASE_URL | Value depends on which Nintex region you are in. US is, for example 'us.nintex.io'. <https://developer.nintex.com/docs/nc-api-docs/d2924cfeea6e8-welcome-to-the-nintex-automation-cloud-api#choose-your-region> |

### Instances - Create Instance

Function to create a workflow instance. Takes in two parameters.

workflow_id: The ID of the workflow you want to create an instance for.

start_data: Optional, any start data the worklfow requires. Should be provided in dictionary format. Returns JSON response if successful.

### Instances - List Instances

Function to return instance data. Takes a number of parameters for filtering what instance data to get.

### Tasks - Delegate Assignment (TODO)

Make function to delegate tasks from one user to another.
