Restructure Project (#16)

<!-- markdownlint-disable-next-line first-line-heading -->
## Description

<!-- Describe your changes in detail. -->
This covers restructuring the project so it can be used from the base
level.

## Context

<!-- Why is this change required? What problem does it solve? -->
It was causing confusion for new people adopting the project.

## Type of changes

<!-- What types of changes does your code introduce? Put an `x` in all
the boxes that apply. -->

- [x] Refactoring (non-breaking change)
- [ ] New feature (non-breaking change which adds functionality)
- [x] Breaking change (fix or feature that would change existing
functionality)
- [ ] Bug fix (non-breaking change which fixes an issue)

## Checklist

<!-- Go over all the following points, and put an `x` in all the boxes
that apply. -->

- [ ] I am familiar with the [contributing
guidelines](../docs/CONTRIBUTING.md)
- [x] I have followed the code style of the project
- [ ] I have added tests to cover my changes
- [x] I have updated the documentation accordingly
- [ ] This PR is a result of pair or mob programming

---

## Sensitive Information Declaration

To ensure the utmost confidentiality and protect your and others
privacy, we kindly ask you to NOT including [PII (Personal Identifiable
Information) / PID (Personal Identifiable
Data)](https://digital.nhs.uk/data-and-information/keeping-data-safe-and-benefitting-the-public)
or any other sensitive data in this PR (Pull Request) and the codebase
changes. We will remove any PR that do contain any sensitive
information. We really appreciate your cooperation in this matter.

- [x] I confirm that neither PII/PID nor sensitive data are included in
this PR and the codebase changes.

Author: davethepunkyone

.gitignore

@@ -11,3 +11,7 @@
 !project.code-workspace
 
 # Please, add your custom content below!
+
+__pycache__/
+.pytest_cache/
+test-results/

README.md

@@ -4,9 +4,9 @@
 
 This project is designed to provide a blueprint to allow for development teams to start quickly developing UI tests using [Playwright Python](https://playwright.dev/python/), providing the base framework and utilities to allow for initial focus on writing tests, rather than configuration of the framework itself.
 
-NOTE: This project is currently under initial development.
+NOTE: This project is currently under initial development so isn't finalised, but should work if you want to experiment with Playwright Python.
 
-> **NOTE: When considering this project, please be advised that currently Playwright is a "proposed" tool within the [NHS England Tech Radar](https://radar.engineering.england.nhs.uk/).  Whilst we are taking steps to get Playwright moved to the "mainstream" section of the radar, as it has not yet been formally adopted it is possible that Playwright may not be fully endorsed by NHS England as a standard tool going forward and using this framework for an NHS England project is at your own risk.**
+> **NOTE: When considering this project, please be advised that currently Playwright is a "proposed" tool within the [NHS England Tech Radar](https://radar.engineering.england.nhs.uk/).  Whilst we are taking steps to get Playwright moved to the "mainstream" section of the radar, as it has not yet been formally adopted it is possible that Playwright may not be fully endorsed by NHS England as a standard tool going forward, and using this framework for an NHS England project is currently at your own risk.**
 
 ## Table of Contents
 
@@ -27,12 +27,6 @@ You can clone this whole repository using the code below:
 git clone https://github.com/nhs-england-tools/playwright-python-blueprint.git
 ```
 
-The code for actually working in Playwright is contained in the blueprint directory, so it's best to do the following to move straight into that working directory:
-
-```shell
-cd nhs-england-tools/playwright-python-blueprint/blueprint
-```
-
 ### Prerequisites
 
 To utilise the blueprint code, you will need to have the following installed:

blueprint/.gitignore

@@ -0,0 +1,5 @@
+#!/bin/sh
+
+BASE_URL=${1:-${BASE_URL}}
+
+pytest --base-url $1