Skip to content

Latest commit

 

History

History
89 lines (65 loc) · 2.79 KB

README.md

File metadata and controls

89 lines (65 loc) · 2.79 KB
Raw

VICAV Web Page

A map-based web application for the VICAV project.

Set up a local instance

Prerequisites

  • Java LTS (Oracle, Azul, or others) (17 at the moment)
  • Node LTS (18 at the moment)
  • git (for Windows, shipped with other OSes)
  • curl for downloading Saxon HE (10.3 at the moment, curl is included with git for windows)
  • This git repository needs to be cloned inside a BaseX ZIP-file distribution (please use 9.7.3 at the moment, version 10.x will be supported soon)

Setup

  • unzip BaseX*.zip (for example in your home folder) <basexhome> is the directory containing BaseX.jar and the bin, lib and webapp directory (basex after unpacking the BaseX*.zip file, but you should probably rename it)
  • in <basexhome>/webapp git clone this repository, please do not change the name vicav-app
  • start a bash in <basexhome>/webapp/vicav-app
  • run git submodule update --init --recursive
  • optionally set the CONTENT_REPOsitory and the CONTENT_BRANCH 
    # default settings if unset
export CONTENT_REPO=https://github.com/acdh-oeaw/vicav-content
export CONTENT_BRANCH=master
  • run ./deployment/initial.sh

This will clone vicav-content into <basexhome>.

Update data and web page code

In <basexhome> execute ./redeploy.sh

Then if

Tests

3 types of tests:

  • XSPEC for unit testing the XSL transformations in ./xslt,
  • XUnit for testing basex API endpoint outputs
  • Cypress for end-to-end testing of the frontend features

Test data is located in ./fixtures. Before running tests locally, you have to setup your test environment with the fixtures.

Tests are automatically executed upon a git push on Gitlab. See https://gitlab.com/acdh-oeaw/vicav/vicav-app/-/pipelines.

To run tests locally you need to tell the scripts where to find BaseX using the CYPRESS_BASEX_ROOT environment variable. E.g.:

$env:CYPRESS_BASEX_ROOT="<basexhome>"
npm run test

XSpec

Installation: Download xspec from https://github.com/xspec/xspec Running a test file: 1a. Windows: <xspechome>/bin/xspec.sh FILENAME 1b. Linux, mac: run <xspechome>/bin/xspec.sh FILENAME

Run xUnit:

Running a test file: Run <basexhome>/bin/basex -t FILENAME

Run cypress

Installation:

  • install nodejs and npm
  • run npm install

Running tests: Either open the GUI with npm run cypress:open or run them on command line with npm run cypress:run.