diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml index 5fd1d1b..f40847e 100644 --- a/.github/workflows/test.yml +++ b/.github/workflows/test.yml @@ -2,9 +2,6 @@ name: Tests on: push: - branches: - - main - pull_request: concurrency: diff --git a/README.md b/README.md index 9f2437c..4684848 100644 --- a/README.md +++ b/README.md @@ -16,6 +16,22 @@ Checkout the [documentation](https://longclawshop.github.io/longclaw/) ![Image of the dashboard](docs/assets/dashboard.png) +## Project Status + +We are working to upgrade the package for the latest versions of Django and Wagtail. While doing this we may need to change the way the package is structured as well as making breaking changes to the code. If you want to use Longclaw in a project, please use the latest release (1.0.2) until we have finished the upgrade. + +### Currently supported versions + +We are currently running the tests against the following versions of Python, Django and Wagtail. + +- Django >= 2.2, < 3.1 +- Wagtail >= 2.11, < 2.14 +- Python >= 3.7, < 3.10 + +### Developers + +If you are interested in working on this project, please use the [Development setup](#development-setup) instructions below to get started. + ## Quickstart Install Longclaw: @@ -61,11 +77,11 @@ python manage.py runserver ## Development setup -Work in progress! +### Work in progress -This is a brief guide to setting up a development environment for Longclaw. +The following instructions are for setting up a development environment for Longclaw while we work on the upgrade. If you want to use Longclaw in a project, please use the latest release (1.0.2) until we have finished the upgrade. -Create a virtualenv and install the requirements +#### Create a virtualenv and install the requirements ```bash python3 -m venv venv @@ -73,13 +89,30 @@ source venv/bin/activate pip install -e ".[testing]" ``` -Run the tests +#### Install and build the frontend + +The frontend is built using node and webpack. The version of node required is v12 (LTS). We recommend using [nvm](https://github.com/nvm-sh/nvm) to manage node versions. + +```bash +cd longclaw/client +``` + +Optional: If you are using nvm, you can run `nvm use` to set the correct version of node. + +Install the dependencies and build the frontend + +```bash +npm install --no-save +npm run build +``` + +#### Run the tests ```bash make test ``` -Run the tests with TOX +#### Run the tests with TOX ```bash make test-all diff --git a/longclaw/client/.nvmrc b/longclaw/client/.nvmrc new file mode 100644 index 0000000..48082f7 --- /dev/null +++ b/longclaw/client/.nvmrc @@ -0,0 +1 @@ +12