README.md

# md-query-saml-uat

User acceptance tests for a service implementing the SAML metadata profile of the Metadata Query Protocol


## Prerequisites

1. Install Robot Framework (see https://github.com/robotframework/robotframework/blob/master/INSTALL.rst)


## Quick Start

1. Clone this repository:
  ```
  git clone https://github.internet2.edu/internet2/md-query-saml-uat.git
  ```

2. Run the robot test suite:
  ```
  robot .
  ```


## Usage

Run all tests:

```
robot .
```

Run metadata aggregate tests:

```
robot All_Entities.robot
```

Run single entity tests:

```
robot Single_Entity.robot
```


## To Do

1. Isolate Python dependencies with `virtualenv` or similar.


## Contributing

1. Clone the repository.
2. Create a new feature branch (optionally named for a JIRA issue, if applicable, e.g. `MDQ-1234-my-feature`).
3. Commit your changes and push to GitHub Enterprise.
4. Create a pull request from your feature branch against the `master` branch.
5. Merge your pull request to the `master` branch.
6. After your changes are merged, you can delete your feature branch.