cypress-allure-adapter

This is allure adapter for cypress providing realtime results. It is useful when using Allure TestOps - so you can watch tests execution.

This is development readme, see package readme for usage documentation

This is under construction.

TODO

• Readme, setup and installation
• proper tests
• tests for plugins

Contribution

todo

Tests

There are 2 types of tests:

• jest tests that start cypress and check results
• cypress tests to see result of plugin work

To run jest test locally:

npm run test:jest:cy

Project structure

Location	description
src	all library code will be located here, see folder src section
integration	folder contains cypress tests for testing the library, see folder integration section
tests	folder contains jest unit tests for testing the library
reports	directory that will be created after tests run with coverage info and reports
.scripts	helper scripts
.github	github actions workflows
.husky	pre-commit hooks (install by npm run husky:install)

Folder src

Your library will contain only the code that located in this folder

Location	Description
src/index.ts	export anything you want to be imported on user side from your library by '' that should run in browser
src/cypress	when you library contains additional commands put types for your commands inside types.ts file When using some other libraries in yours you can import its types within cypress.ts Note: this folder should have cypress name for easier types setup when you library is ready (this way you will not need to add your library in tsconfig.json types section)
src/plugins	when you library need to handle node events (register tasks or other things on node side) you can put it all here. Export all required methods within index.ts file. So when using library user imports will be '<your library name>/plugins'
src/setup	all functions that should be run in browser, export within index.ts
src/utils	some functions that can be run on both environments - node and DOM (browser), export within index.ts

Folder integration

Location	description
integration/plugins	use your plugins from src here ts-preprocessor.ts is requiered to gather coverage info
integration/support	use your src/support, import it replacing src with cy-local to have correct code coverage
integration/e2e	tests folder, use anything from src, import it replacing src with cy-local to have correct code coverage

Code coverage

Coverage is being gathered from cypress and from jest, after all tests finished coverages from both test packs will be merged

To see individual coverage reports run:

• npm run cov:jest html report with coverage for jest tests
• npm run cov:cy html report with coverage for jest tests
• npm run cov html report with combined coverage

Publishing

• npm run publish:patch - publish patch
• npm run publish:minor - publish minor
• npm run publish:major - publish major
• npm run publish:pack - publish version specified in package.json script

Scripts

script	description
husky:install	install precommit hooks
lint	lint code
build	compile typescript by tsconfig.build.json
test	run all jest tests
test:cov	run all jest tests with coverage
cy:open	start cypress in interactive mode
cy:open:cov	start cypress in interactive mode with coverage
cy:run	run cypress tests
cy:run:cov	run cypress tests with coverage
cov:merge	merge jest and cypress coverage results
cov:jest	show html report for jest coverage (http-server should be installed globally, npm i http-server -g)
cov:cy	show html report for cypress coverage (http-server should be installed globally, npm i http-server -g)
cov	show html report for full coverage (http-server should be installed globally, npm i http-server -g)
cov:check	check coverage by thresholds specified in nyc.config.js
pre	run all necessary scripts (fmt, lint, build, tests and check cov)