# Tests library

## Use an AWS BDD account
*Available since 1.2*

Get an AWS account to perform any integration testing with AWS services and release when exiting the context

### Signature

`tests.withBDDAccount(currentBuild, needeed_time = 3600, Closure inner)`

*Parameter*

- `currentBuild` is the meta object pointing to the current build
- `needeed_time` is the maximum time this account would be used for. **Account will be reset after that time**
- `inner` is the closure that will be executed while this account is allocated. The allocated account object is passed as **first argument**

### Examples

Simple usage:

```groovy
tests.withBDDAccount(currentBuild, 3600){ account ->
    println "Using account ${account.getName()} with ID ${account.getID()}"
}
```

## BDD account
*Available since 1.2*

Object that represent a BDD account

### Symbol

`tests.BDDAccount`

### Method

#### toString()

Represent this object in a string of the format `<Name>[<AccountID>]`

**Return**: String

#### getName()

Getter for the account name. I.e: `bdd3`

**Return**: String

#### getID()

Getter for the account ID. I.e: `012345678912s`

**Return**: String