Add basic Cypress end-to-end testing

Author: abelsiqueira

.eslintrc.js

@@ -42,6 +42,8 @@ module.exports = {
     'plugin:vue/vue3-strongly-recommended', // Priority B: Strongly Recommended (Improving Readability)
     // 'plugin:vue/vue3-recommended', // Priority C: Recommended (Minimizing Arbitrary Choices and Cognitive Overhead)
 
+    'plugin:cypress/recommended',
+
     'standard'
 
   ],

.github/workflows/test.yml

@@ -24,4 +24,14 @@ jobs:
     - name: Run unit tests
       run: npm run test:unit:ci
 
-
+  cypress:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+      with:
+        ref: ${{ github.head_ref }}
+    - name: Cypress run
+      uses: cypress-io/github-action@v4
+      with:
+        start: npm run dev
+        wait-on: 'http://localhost:8080/cff-initializer-javascript/#'

.gitignore

@@ -32,3 +32,8 @@ yarn-error.log*
 *.njsproj
 *.sln
 node_modules
+
+# Cypress
+cypress/downloads
+cypress/screenshots
+cypress/videos

README.dev.md

@@ -51,6 +51,8 @@ npm run build
 
 ## Tests
 
+### Unit tests
+
 We use `Jest` for unit tests. The unit tests can be found under `test/jest/__tests__/` folder.
 
 You can run the test with
@@ -65,6 +67,20 @@ You can also use the Majestic web interface to run the unit tests in your browse
 npm run test:unit:ui
 ```
 
+### End-to-end tests
+
+We use [Cypress](https://cypress.io) for end-to-end tests. These tests can be found under the `cypress/e2e` folder.
+
+You can start Cypress with
+
+```shell
+npm run cypress:open
+```
+
+Select "E2E Testing", which should be configured already and select the desired browser and click the start button.
+
+A browser will open with the list of tests, which can be explored.
+
 ## Linting and formatting
 
 ```shell

cypress.config.ts

@@ -0,0 +1,7 @@
+import { defineConfig } from 'cypress'
+
+export default defineConfig({
+    e2e: {
+        baseUrl: 'http://localhost:8080/cff-initializer-javascript/#'
+    }
+})

cypress/e2e/spec.cy.ts

@@ -0,0 +1,40 @@
+const minimumCff = '# This CITATION.cff file was generated with cffinit.\n# Visit https://bit.ly/cffinit to generate yours today!\n\ncff-version: 1.2.0\ntitle: My Title\nmessage: >-\n  If you use this software, please cite it using the\n  metadata from this file.\ntype: software\nauthors:\n  - {}\n'
+
+describe('Minimum usage', () => {
+    it('Visit site, fill minimum information and download', () => {
+        // Main screen
+        cy.visit('/')
+        cy.contains('Generate your citation metadata files with ease')
+        cy.get('[data-cy="btn-create"]')
+            .click()
+
+        // Start screen
+        cy.url().should('include', '/start')
+        cy.get('[data-cy="input-title"]')
+            .type('My Title')
+            .should('have.value', 'My Title')
+        cy.get('[data-cy="input-message"]')
+            .should('have.value', 'If you use this software, please cite it using the metadata from this file.')
+        cy.get('[data-cy="btn-next"]')
+            .click()
+
+        // Author screen
+        cy.url().should('include', '/authors')
+        cy.get('[data-cy="btn-add-author"]')
+            .click()
+        cy.get('[data-cy="btn-done"]')
+            .click()
+        cy.get('[data-cy="btn-next"]')
+            .click()
+
+        // Finish Minimum screen
+        cy.url().should('include', '/finish-minimum')
+        cy.get('[data-cy="btn-download"]')
+            .click()
+        const downloadsFolder = Cypress.config('downloadsFolder')
+        const cfffile = `${downloadsFolder}/CITATION.cff`
+
+        cy.readFile(cfffile, 'binary', { timeout: 400 })
+            .should(buffer => expect(buffer).to.be.equal(minimumCff))
+    })
+})

cypress/fixtures/example.json

@@ -0,0 +1,5 @@
+{
+  "name": "Using fixtures to represent data",
+  "email": "hello@cypress.io",
+  "body": "Fixtures are a great way to mock data for responses to routes"
+}

cypress/support/commands.ts

@@ -0,0 +1,37 @@
+/// <reference types="cypress" />
+// ***********************************************
+// This example commands.ts shows you how to
+// create various custom commands and overwrite
+// existing commands.
+//
+// For more comprehensive examples of custom
+// commands please read more here:
+// https://on.cypress.io/custom-commands
+// ***********************************************
+//
+//
+// -- This is a parent command --
+// Cypress.Commands.add('login', (email, password) => { ... })
+//
+//
+// -- This is a child command --
+// Cypress.Commands.add('drag', { prevSubject: 'element'}, (subject, options) => { ... })
+//
+//
+// -- This is a dual command --
+// Cypress.Commands.add('dismiss', { prevSubject: 'optional'}, (subject, options) => { ... })
+//
+//
+// -- This will overwrite an existing command --
+// Cypress.Commands.overwrite('visit', (originalFn, url, options) => { ... })
+//
+// declare global {
+//   namespace Cypress {
+//     interface Chainable {
+//       login(email: string, password: string): Chainable<void>
+//       drag(subject: string, options?: Partial<TypeOptions>): Chainable<Element>
+//       dismiss(subject: string, options?: Partial<TypeOptions>): Chainable<Element>
+//       visit(originalFn: CommandOriginalFn, url: string, options: Partial<VisitOptions>): Chainable<Element>
+//     }
+//   }
+// }

cypress/support/e2e.ts

@@ -0,0 +1,20 @@
+// ***********************************************************
+// This example support/e2e.ts is processed and
+// loaded automatically before your test files.
+//
+// This is a great place to put global configuration and
+// behavior that modifies Cypress.
+//
+// You can change the location of this file or turn off
+// automatically serving support files with the
+// 'supportFile' configuration option.
+//
+// You can read more here:
+// https://on.cypress.io/configuration
+// ***********************************************************
+
+// Import commands.js using ES2015 syntax:
+// import './commands'
+
+// Alternatively you can use CommonJS syntax:
+require('./commands')