README.md

# md-query-saml-uat

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

See also:

* [Metadata Query Protocol](https://tools.ietf.org/html/draft-young-md-query-09)
* [SAML Profile for the Metadata Query Protocol](https://tools.ietf.org/html/draft-young-md-query-saml-09)




## 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. Edit `variables.py` for your environment.

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


## Usage

Treat any test cases tagged with `optional` as noncritical:
```
robot --noncritical optional .
```

Additionally skip long-running test cases (those that download and parse all
entities):
```
robot --noncritical optional --exclude aggregate .
```


## To Do

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


## Contributing

1. Clone the repository
2. Create a new feature branch
3. Commit your changes and push to the repository
4. Create a pull request from your feature branch against the `master` branch
5. After your changes have been merged, you may delete your feature branch